ClusterResourceTypeControl-Funktion (clusapi.h)

Initiiert einen Vorgang, der sich auf einen Ressourcentyp auswirkt. Der ausgeführte Vorgang hängt vom Steuerelementcode ab, der an den dwControlCode-Parameter übergeben wird.

Syntax

DWORD ClusterResourceTypeControl(
  [in]            HCLUSTER hCluster,
  [in]            LPCWSTR  lpszResourceTypeName,
  [in, optional]  HNODE    hHostNode,
  [in]            DWORD    dwControlCode,
  [in, optional]  LPVOID   lpInBuffer,
  [in]            DWORD    nInBufferSize,
  [out, optional] LPVOID   lpOutBuffer,
  [in]            DWORD    nOutBufferSize,
  [out, optional] LPDWORD  lpBytesReturned
);

Parameter

[in] hCluster

Handle an den Cluster, der den in lpszResourceTypeName identifizierten Ressourcentyp enthält.

[in] lpszResourceTypeName

Zeiger auf eine MIT NULL endende Unicode-Zeichenfolge, die den Namen des betroffenen Ressourcentyps enthält.

[in, optional] hHostNode

Handle an den Knoten, auf dem der betroffene Ressourcentyp gehostet wird.

[in] dwControlCode

Ein Ressourcentypsteuerungscode , der den auszuführenden Vorgang angibt. Informationen zur Syntax, die einem Steuerelementcode zugeordnet ist, finden Sie unter
Steuerungscodearchitektur und die folgenden Themen:

• CLUSCTL_RESOURCE_TYPE_ENUM_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_ENUM_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_CHARACTERISTICS
• CLUSCTL_RESOURCE_TYPE_GET_CLASS_INFO
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_COMMON_RESOURCE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_CRYPTO_CHECKPOINTS
• CLUSCTL_RESOURCE_TYPE_GET_FLAGS
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_PRIVATE_RESOURCE_PROPERTY_FMTS
• CLUSCTL_RESOURCE_TYPE_GET_REGISTRY_CHECKPOINTS
• CLUSCTL_RESOURCE_TYPE_GET_REQUIRED_DEPENDENCIES
• CLUSCTL_RESOURCE_TYPE_GET_RO_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_GET_RO_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_QUERY_DELETE
• CLUSCTL_RESOURCE_TYPE_SET_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_SET_PRIVATE_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_STORAGE_GET_AVAILABLE_DISKS
• CLUSCTL_RESOURCE_TYPE_STORAGE_GET_RESOURCEID
• CLUSCTL_RESOURCE_TYPE_UNKNOWN
• CLUSCTL_RESOURCE_TYPE_VALIDATE_COMMON_PROPERTIES
• CLUSCTL_RESOURCE_TYPE_VALIDATE_PRIVATE_PROPERTIES

[in, optional] lpInBuffer

Zeiger auf den Eingabepuffer mit informationen, die für den Vorgang benötigt werden, oder NULL , wenn keine Informationen benötigt werden.

[in] nInBufferSize

Anzahl der Bytes im Puffer, auf den lpInBuffer verweist.

[out, optional] lpOutBuffer

Zeiger auf den Ausgabepuffer mit Informationen, die sich aus dem Vorgang ergeben, oder NULL , wenn nichts zurückgegeben wird.

[in] nOutBufferSize

Anzahl von Bytes im Ausgabepuffer, auf den lpOutBuffer verweist, oder null, wenn der Aufrufer nicht weiß, wie viele Daten zurückgegeben werden.

[out, optional] lpBytesReturned

Zeiger auf die Anzahl von Bytes im Puffer, auf die lpOutBuffer verweist, die als Ergebnis des Vorgangs tatsächlich ausgefüllt wurden. Der Aufrufer kann NULL für lpBytesReturned übergeben, wenn ClusterResourceTypeControl die Anzahl der Bytes im Ausgabepuffer nicht zurückgeben muss.

Rückgabewert

Die Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
ERROR_SUCCESS	Der Vorgang wurde durchgeführt. Wenn für den Vorgang ein Ausgabepuffer erforderlich ist, verweist lpBytesReturned (wenn nicht NULL bei der Eingabe) auf die tatsächliche Größe der im Puffer zurückgegebenen Daten.
ERROR_MORE_DATA	Der Ausgabepuffer, auf den lpOutBuffer verweist, war nicht groß genug, um die daten, die sich aus dem Vorgang ergeben, aufzunehmen. Der parameter lpBytesReturned (wenn nicht NULL bei der Eingabe) zeigt auf die größe, die für den Ausgabepuffer erforderlich ist. Nur Vorgänge, die einen Ausgabepuffer erfordern, geben ERROR_MORE_DATA zurück. Wenn der lpOutBuffer-ParameterNULL und der nOutBufferSize-Parameter null ist, können ERROR_SUCCESS zurückgegeben werden, nicht ERROR_MORE_DATA.
Systemfehlercode	Der Vorgang war nicht erfolgreich. Wenn für den Vorgang ein Ausgabepuffer erforderlich ist, ist der von lpBytesReturned angegebene Wert unzuverlässig.

Hinweise

Wenn ClusterResourceTypeControlERROR_MORE_DATA zurückgibt, legen Sie nOutBufferSize auf die Anzahl der Bytes fest, auf die lpBytesReturned verweist, und rufen Sie die Funktion erneut auf.

Übergeben Sie LPC- und RPC-Handles nicht an denselben Funktionsaufruf. Andernfalls löst der Aufruf eine RPC-Ausnahme aus und kann zusätzliche destruktive Auswirkungen haben. Informationen dazu, wie LPC- und RPC-Handles erstellt werden, finden Sie unter LPC- und RPC-Handles und OpenCluster.

ClusterResourceTypeControl ist eine der Steuerelementcodefunktionen. Weitere Informationen zu Steuercodes und Steuerelementcodefunktionen finden Sie unter Verwenden von Steuercodes.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform	Windows
Kopfzeile	clusapi.h
Bibliothek	ClusAPI.lib
DLL	ClusAPI.dll

Weitere Informationen

OpenCluster

Steuerungscodes für Ressourcentypen