Freigeben über


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)

Weitere Informationen

IWiaDrvItem

IWiaDrvItem::GetFullItemName