ClusterResourceTypeControlAsUser-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 ClusterResourceTypeControlAsUser(
[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
Behandeln Sie den Cluster, der den in lpszResourceTypeName identifizierten Ressourcentyp enthält.
[in] lpszResourceTypeName
Zeiger auf eine MIT NULL beendete Unicode-Zeichenfolge, die den Namen des betroffenen Ressourcentyps enthält.
[in, optional] hHostNode
Behandeln Sie den Knoten, auf dem der betroffene Ressourcentyp gehostet wird.
[in] dwControlCode
Ein Von der CLUSCTL_RESOURCE_TYPE_CODES-Enumeration aufgelisteter Ressourcensteuerungscode, der den auszuführenden Vorgang angibt. Informationen zur Syntax, die einem Steuerelementcode zugeordnet ist, finden Sie im Link zum thema CLUSCTL_RESOURCE_TYPE_CODES .
[in, optional] lpInBuffer
Zeiger auf den Eingabepuffer mit informationen, die für den Vorgang erforderlich sind, oder NULL , wenn keine Informationen benötigt werden.
[in] nInBufferSize
Anzahl der Bytes im Puffer, auf die von lpInBuffer verwiesen wird.
[out, optional] lpOutBuffer
Zeiger auf den Ausgabepuffer mit Informationen, die sich aus dem Vorgang ergeben, oder NULL , wenn nichts zurückgegeben wird.
[in] nOutBufferSize
Die Anzahl der Bytes im Ausgabepuffer, auf den lpOutBuffer verweist, oder 0, 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 übergeben muss.
Rückgabewert
Die Funktion gibt einen der folgenden Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
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. |
|
Der Ausgabepuffer, auf den lpOutBuffer verweist, war nicht groß genug, um die aus dem Vorgang resultierenden Daten aufzunehmen. Der parameter lpBytesReturned (wenn nicht NULL bei der Eingabe) verweist 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, werden möglicherweise ERROR_SUCCESS zurückgegeben, nicht ERROR_MORE_DATA. |
| 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 von lpBytesReturned verwiesen wird, 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 zum Erstellen von LPC- und RPC-Handles finden Sie unter LPC- und RPC-Handles und OpenCluster.
ClusterResourceTypeControl ist eine der Steuerelementcodefunktionen. Weitere Informationen zu Steuercodes und Steuerungscodefunktionen finden Sie unter Verwenden von Steuercodes.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2016 |
| Zielplattform | Windows |
| Kopfzeile | clusapi.h |
| Bibliothek | ClusAPI.lib |
| DLL | ClusAPI.dll |