PRESOURCE_CONTROL_ROUTINE Rückruffunktion (resapi.h)

Artikel
08/25/2023

Führt einen Vorgang aus, der für eine Ressource gilt. Der PRESOURCE_CONTROL_ROUTINE Typ definiert einen Zeiger auf diese Funktion.

Syntax

PRESOURCE_CONTROL_ROUTINE PresourceControlRoutine;

DWORD PresourceControlRoutine(
  [in]            RESID Resource,
  [in]            DWORD ControlCode,
  [in, optional]  PVOID InBuffer,
  [in]            DWORD InBufferSize,
  [out, optional] PVOID OutBuffer,
  [in]            DWORD OutBufferSize,
  [out]           LPDWORD BytesReturned
)
{...}

Parameter

[in] Resource

Ressourcenbezeichner der betroffenen Ressource.

[in] ControlCode

Steuerungscode , der den auszuführenden Vorgang darstellt. Eine Liste der gültigen Werte für den ControlCode-Parameter finden Sie unter Ressourcentypkontrollcodes.

[in, optional] InBuffer

Zeiger auf einen Puffer, der Daten enthält, die im Vorgang verwendet werden sollen. InBuffer kann NULL sein, wenn keine Daten erforderlich sind.

[in] InBufferSize

Größe des Puffers, auf den in InBuffer verwiesen wird, in Bytes.

[out, optional] OutBuffer

Zeiger auf einen Puffer, der daten enthält, die sich aus dem Vorgang ergeben. OutBuffer kann NULL sein, wenn der Vorgang keine Daten zurückgeben muss.

[in] OutBufferSize

Größe des verfügbaren Speicherplatzes in Byte, auf den outBuffer verweist.

[out] BytesReturned

Die tatsächliche Größe der Daten, die sich aus dem Vorgang ergeben, in Bytes.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der ControlCode zugeordnete Vorgang wurde erfolgreich abgeschlossen.
ERROR_INVALID_FUNCTION 1	Die Ressourcen-DLL hat angefordert, dass der Ressourcenmonitor zusätzlich zur verarbeitung, die von der DLL bereitgestellt wird (falls vorhanden), die Standardverarbeitung (sofern vorhanden) für ControlCode ausführt.
ERROR_MORE_DATA 234 (0xEA)	Die zugeordnete Größe von OutBuffer war zu klein, um die angeforderten Daten zu speichern. BytesReturned gibt die erforderliche Größe an. Schließen Sie beim Berechnen der Bytegrößen von Zeichenfolgen immer den abschließenden NULL-Wert ein.
ERROR_RESOURCE_PROPERTIES_STORED 5024 (0x13A0)	Gibt an, dass neue Eigenschaftswerte für eine Ressource in der Clusterdatenbank festgelegt wurden, die Eigenschaften jedoch noch nicht wirksam wurden. Die neuen Eigenschaftswerte werden angewendet, nachdem die Ressource offline geschaltet und online geschaltet wurde.
Fehlercode	Die Operation war nicht erfolgreich.

Hinweise

Einige Steuercodes sollten von der Ressourcen-DLL verarbeitet werden, während andere dem Ressourcenmonitor überlassen werden sollten. Effektive Implementierungsstrategien der ResourceControl-Einstiegspunktfunktion finden Sie unter Implementieren von ResourceControl.

Beispiele

Weitere Informationen finden Sie unter Ressourcen-DLL-Beispiele.

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	resapi.h

Weitere Informationen

Ressourcen-DLL Entry-Point Functions

Freigeben über