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.

Anforderungen

Weitere Informationen

IPart-Schnittstelle