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 erhält, die den vollständigen Namen des Elements enthält.
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_OK zurück. Wenn die Methode die Zeichenfolge aufgrund unzureichenden Arbeitsspeichers nicht zuordnet, gibt sie E_OUTOFMEMORY zurück. Wenn der Parameter pbstrFullItemName 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, ordnet diese Methode eine Zeichenfolge zu, die den vollständigen Namen des aktuellen Elements einschließlich Pfadinformationen enthält. Die -Methode gibt einen Zeiger auf die Zeichenfolge in pbstrFullItemName zurück. Der Minidriver muss die Zuordnung des von der Zeichenfolge verwendeten Arbeitsspeichers aufheben, indem die SysFreeString-Funktion aufgerufen wird.
Der in pbstrFullItemName zurückgegebene Name ist der Name, der dem Element zugeordnet ist, als das Element zum ersten Mal von der Treiberdienstbibliotheksfunktion wiasCreateDrvItem erstellt wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (wiamindr.h einschließen) |