IPart::GetName-Methode (devicetopology.h)
Die GetName-Methode ruft den Anzeigenamen dieses Teils ab.
Syntax
HRESULT GetName(
[out] LPWSTR *ppwstrName
);
Parameter
[out] ppwstrName
Zeiger auf eine Zeigervariable, in die die -Methode die Adresse einer mit NULL beendeten breitzeichenigen Zeichenfolge schreibt, die den Anzeigenamen dieses Teils enthält. Die -Methode weist den Speicher für die Zeichenfolge zu. Der Aufrufer ist für das Freigeben des Speichers verantwortlich, wenn er nicht mehr benötigt wird, indem er die CoTaskMemFree-Funktion aufruft . Wenn der GetName-Aufruf fehlschlägt, ist *ppwstrNameNULL. Informationen zu CoTaskMemFree finden Sie in der Dokumentation zum Windows SDK.
Rückgabewert
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn ein Fehler auftritt, können mögliche Rückgabecodes die in der folgenden Tabelle gezeigten Werte umfassen, sind jedoch nicht darauf beschränkt.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ppwstrName ist NULL. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | devicetopology.h |