IWiaDrvItem::GetFullItemName-Methode (wiamindr_lh.h)
Die IWiaDrvItem::GetFullItemName Methode ruft den vollständigen Namen des Elements ab, einschließlich Pfadinformationen.
Syntax
HRESULT GetFullItemName(
BSTR *__MIDL__IWiaDrvItem0002
);
Parameter
__MIDL__IWiaDrvItem0002
pbstrFullItemName [out, optional]
Verweist auf einen Speicherspeicherort, der die Adresse einer Zeichenfolge mit dem vollständigen Namen des Elements empfängt.
Rückgabewert
Wenn die Methode erfolgreich ist, speichert sie einen Zeiger auf den vollständigen Namen des Elements, einschließlich Pfadinformationen, in pbstrFullItemName und gibt S_OKzurück. Wenn die Methode die Zeichenfolge aufgrund unzureichenden Arbeitsspeichers nicht zuweist, wird E_OUTOFMEMORYzurückgegeben. Wenn der Parameter pbstrFullItemName ungültig ist, gibt die Methode E_INVALIDARGzurück. Wenn die Methode aus einem anderen Grund fehlschlägt, wird ein standardmäßiger COM-Fehlercode zurückgegeben.
Bemerkungen
Wenn genügend Arbeitsspeicher verfügbar ist, weist diese Methode eine Zeichenfolge mit dem vollständigen Namen des aktuellen Elements einschließlich Pfadinformationen zu. Die Methode gibt einen Zeiger auf die Zeichenfolge in pbstrFullItemNamezurück. Der Minidriver muss den von der Zeichenfolge verwendeten Speicher durch Aufrufen der SysFreeString--Funktion behandeln.
Der in pbstrFullItemName zurückgegebene Name ist der Name, der dem Element zugeordnet ist, als das Element zum ersten Mal von der Treiberdienstbibliotheksfunktion wiasCreateDrvItemerstellt wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiamindr_lh.h (include Wiamindr.h) |