Freigeben über

ClusterResourceControl-Funktion (clusapi.h)

  • Artikel

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

Syntax

DWORD ClusterResourceControl(
  [in]            HRESOURCE hResource,
  [in, optional]  HNODE     hHostNode,
  [in]            DWORD     dwControlCode,
  [in, optional]  LPVOID    lpInBuffer,
  [in]            DWORD     cbInBufferSize,
  [out, optional] LPVOID    lpOutBuffer,
  [in]            DWORD     cbOutBufferSize,
  [out, optional] LPDWORD   lpBytesReturned
);

Parameter

[in] hResource

Handle für die ressource, die betroffen ist.

[in, optional] hHostNode

Optionales Handle für den Knoten, um den Vorgang auszuführen. Wenn NULL, führt der Knoten, der die von hResource identifizierte Ressource besitzt, den Vorgang aus.

[in] dwControlCode

Ein Ressourcensteuerungscode, der von der CLUSCTL_RESOURCE_CODES Enumeration aufgezählt wird und den auszuführenden Vorgang angibt. Informationen zur Syntax, die einem Steuerelementcode zugeordnet ist, finden Sie unter
Steuerungscodearchitektur und die folgenden Themen:

[in, optional] lpInBuffer

Zeiger auf einen Eingabepuffer, der informationen enthält, die für den Vorgang erforderlich sind, oder NULL , wenn keine Informationen benötigt werden.

[in] cbInBufferSize

Die zugeordnete Größe (in Bytes) des Eingabepuffers.

[out, optional] lpOutBuffer

Zeiger auf einen Ausgabepuffer zum Empfangen der daten, die sich aus dem Vorgang ergeben, oder NULL , wenn keine Daten zurückgegeben werden.

[in] cbOutBufferSize

Die zugeordnete Größe (in Bytes) des Ausgabepuffers.

[out, optional] lpBytesReturned

Gibt die tatsächliche Größe (in Bytes) der Daten zurück, die sich aus dem Vorgang ergeben. Wenn diese Informationen nicht benötigt werden, übergeben Sie NULL für lpBytesReturned.

Rückgabewert

Die Funktion gibt einen der folgenden Werte zurück.

Rückgabecode/-wert BESCHREIBUNG
ERROR_SUCCESS
0
 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
234 (0xEA)
 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 cbOutBufferSize-Parameter null ist, werden möglicherweise ERROR_SUCCESS zurückgegeben, nicht ERROR_MORE_DATA.
ERROR_RESOURCE_PROPERTIES_STORED
5024 (0x13A0)
 Gilt nur für CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES und CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES. Gibt an, dass die Eigenschaften erfolgreich gespeichert, aber noch nicht auf die Ressource angewendet wurden. Die neuen Eigenschaften werden wirksam, nachdem die Ressource offline geschaltet und wieder online geschaltet wurde.
ERROR_HOST_NODE_NOT_RESOURCE_OWNER
5015 (0x1397)
 Der vom hNode-Parameter angegebene Knoten ist nicht der Knoten, der besitzer der von hResource angegebenen Ressource ist.
Systemfehlercode
 Der Vorgang war nicht erfolgreich. Wenn für den Vorgang ein Ausgabepuffer erforderlich ist, ist der von lpBytesReturned angegebene Wert (wenn bei der Eingabe nicht NULL ) angegeben wird, unzuverlässig.

Hinweise

Wenn ClusterResourceControlERROR_MORE_DATA zurückgibt, legen Sie cbOutBufferSize 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.

Die ClusterResourceControl-Funktion 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

Ressourcensteuerungscodes