IGetClusterResourceInfo::GetResourceNetworkName-Methode (cluadmex.h)
[Diese Methode steht für die Verwendung in den Betriebssystemen zur Verfügung, die im Abschnitt Anforderungen angegeben sind. Die Unterstützung für diese Methode wurde in Windows Server 2008 entfernt.]
Gibt den Namen des Netzwerks zurück, das von der Netzwerknamenressource verwaltet wird, von der eine Ressource abhängt.
Syntax
BOOL GetResourceNetworkName(
[in] LONG lObjIndex,
[out] BSTR lpszNetName,
[in, out] ULONG *pcchNetName
);
Parameter
[in] lObjIndex
Eine Zahl, die den nullbasierten Index der Zielressource darstellt. Die Zielressource hängt möglicherweise von einer Netzwerknamenressource ab. lObjIndex ist auf die Nummer beschränkt, die durch Aufrufen von IGetClusterDataInfo::GetObjectCount abgerufen werden kann.
[out] lpszNetName
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des Netzwerks enthält, von dem die von lObjIndex indizierte Ressource abhängt. Obwohl dieser Parameter als BSTR deklariert ist, wird er als LPWSTR implementiert.
[in, out] pcchNetName
Zeiger auf die maximale Anzahl von Zeichen des Puffers, auf den lpszNetName verweist. Bei der Eingabe sollte dieser Wert groß genug sein, um MAX_COMPUTERNAME_LENGTH + 1 Zeichen zu enthalten. In der Ausgabe zeigt pcchNetName auf die tatsächliche Anzahl von Zeichen, die in den Inhalt von lpszNetName kopiert wurden.
Rückgabewert
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die von lObjIndex indizierte Ressource weist eine Abhängigkeit von einer Netzwerknamenressource auf, und der Name des Netzwerks wurde erfolgreich zurückgegeben. |
|
Die von lObjIndex indizierte Ressource weist keine Abhängigkeit von einer Netzwerknamenressource auf. |
Hinweise
Die GetResourceNetworkName-Methode ist erforderlich, um die Eigenschaftenseiten der Failoverclusteradministrator-Erweiterung zu bestimmen, ob eine Ressource eine vorhandene oder ausstehende Abhängigkeit von einer Netzwerknamenressource aufweist.
Der Name des Netzwerks wird in der privaten Eigenschaft Name der Netzwerknameressource gespeichert. Die allgemeine Eigenschaft Name der Netzwerknameressource ist der Name der Ressource, nicht des Netzwerks.
MAX_COMPUTERNAME_LENGTH ist eine Konstante, die in der Windows-Headerdatei WinBase.h als 15 definiert ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 Enterprise, Windows Server 2003 Datacenter |
| Zielplattform | Windows |
| Kopfzeile | cluadmex.h |