IGetClusterObjectInfo::GetObjectName-Methode (cluadmex.h)
[Diese Methode ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Die Unterstützung für diese Methode wurde in Windows Server 2008 entfernt.]
Gibt den Namen eines Clusterobjekts zurück.
Syntax
HRESULT GetObjectName(
[in] LONG lObjIndex,
[out] BSTR lpszName,
[in, out] LONG *pcchName
);
Parameter
[in] lObjIndex
Eine Zahl, die den nullbasierten Index des Zielobjekts darstellt. lObjIndex ist auf die Nummer beschränkt, die durch Aufrufen von IGetClusterDataInfo::GetObjectCount abgerufen werden kann.
[out] lpszName
Zeiger auf eine unicode-Zeichenfolge mit Null-Termin, die den Namen des Objekts enthält, das lObjIndex zugeordnet ist. Der lpszName-Parameter kann NULL sein, was angibt, dass der Aufrufer nur die Namenslänge anfordert. Obwohl dieser Parameter als BSTR deklariert ist, wird er als LPWSTR implementiert.
[in, out] pcchName
Zeigen Sie bei der Eingabe auf die Anzahl der Zeichen im Puffer, auf die der parameter lpszName verweist. Der parameter pcchName darf nicht NULL sein. Zeigen Sie in der Ausgabe auf die Anzahl der Zeichen im Namen, die im Inhalt von lpszName gespeichert sind, einschließlich des NULL-Endzeichens.
Rückgabewert
Wenn GetObjectName nicht erfolgreich ist, kann es andere HRESULT-Werte zurückgeben.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Mindestens einer der Parameter ist ungültig. |
|
Der Puffer, auf den lpszName verweist, ist zu klein, um den angeforderten Namen zu enthalten. GetObjectName gibt die erforderliche Anzahl von Zeichen im Inhalt von pcchName zurück. |
Hinweise
Wenn der lpszName-Parameter als NULL angegeben ist, gibt die GetObjectName-MethodeNOERROR zurück.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 Enterprise, Windows Server 2003 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | cluadmex.h |