IWiaDrvItem::GetItemName-Methode (wiamindr_lh.h)
Die IWiaDrvItem::GetItemName-Methode ruft den aktuellen IWiaDrvItem-Elementnamen ab, ohne Pfadinformationen.
Syntax
HRESULT GetItemName(
BSTR *__MIDL__IWiaDrvItem0003
);
Parameter
__MIDL__IWiaDrvItem0003
pbstrItemName [out, optional]
Zeigt auf einen Speicherspeicherort, der die Adresse der Zeichenfolge erhält, die den Elementnamen enthält.
Rückgabewert
Wenn die Methode erfolgreich ist, speichert sie einen Zeiger auf den Namen des Elements (Pfadinformationen sind nicht enthalten) in pbstrItemName und gibt S_OK zurück. Wenn die Methode die Zeichenfolge aufgrund von unzureichendem Arbeitsspeicher nicht zuordnen kann, gibt sie E_OUTOFMEMORY zurück. Wenn der Parameter pbstrItemName ungültig ist, gibt die Methode E_INVALIDARG zurück. Wenn die Methode aus einem anderen Grund fehlschlägt, wird ein COM-Standardfehlercode zurückgegeben.
Hinweise
Wenn genügend Arbeitsspeicher verfügbar ist, weist die -Methode eine Zeichenfolge zu, die den Namen des aktuellen Elements enthält, ohne Pfadinformationen. Die -Methode gibt einen Zeiger auf die Zeichenfolge in pbstrItemName zurück. Der Minidriver muss die Zuordnung des von der Zeichenfolge verwendeten Arbeitsspeichers durch Aufrufen der SysFreeString-Funktion aufheben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (einschließlich Wiamindr.h) |