ClusterRegReadBatchAddCommand-Funktion (clusapi.h)

Fügt einem Batch einen Lesebefehl hinzu, der für einen Clusterregistrierungsschlüssel ausgeführt wird.

Syntax

LONG ClusterRegReadBatchAddCommand(
  [in]           HREGREADBATCH hRegReadBatch,
  [in, optional] LPCWSTR       wzSubkeyName,
  [in, optional] LPCWSTR       wzValueName
);

Parameter

[in] hRegReadBatch

Das Handle des Lesebatches, dem ein Befehl hinzugefügt wird. Erstellen Sie einen Batch, indem Sie die ClusterRegCreateReadBatch-Funktion aufrufen.

[in, optional] wzSubkeyName

Der Name des Schlüssels relativ zum Clusterregistrierungsschlüssel. Wenn dieser Name NULL ist, wird der Lesevorgang für den Clusterregistrierungsschlüssel ausgeführt, der im hRegReadBatch-Parameter dargestellt wird.

[in, optional] wzValueName

Der Name des zu lesenden Registrierungswerts. Wenn dieser Name NULL ist, wird der Inhalt des Standardwerts zurückgegeben.

Rückgabewert

Die Funktion gibt einen der folgenden Systemfehlercodes zurück.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_SUCCESS 0	Der Vorgang wurde durchgeführt.
ERROR_OUTOFMEMORY 14	Für diesen Vorgang ist nicht genügend Speicher verfügbar.
ERROR_INVALID_HANDLE 6	hRegReadBatch ist NULL oder ungültig.

Hinweise

Zusätzliche Aufrufe der ClusterRegReadBatchAddCommand-Funktion fügen dem Batch zusätzliche Lesebefehle hinzu.

Anforderungen

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

Weitere Informationen

ClusterRegCreateReadBatch