Freigeben über

OpenClusterResourceEx-Funktion (clusapi.h)

  • Artikel

Öffnet eine Ressource und gibt ein Handle zurück.

Syntax

HRESOURCE OpenClusterResourceEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszResourceName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Parameter

[in] hCluster

Handle für einen Cluster.

[in, optional] lpszResourceName

Zeiger auf eine Unicode-Zeichenfolge mit Null-Termin, die den Namen der zu öffnenden Ressource enthält.

Bei Ressourcennamen wird die Groß-/Kleinschreibung nicht beachtet. Ein Ressourcenname muss innerhalb des Clusters eindeutig sein. Der Name wird festgelegt, wenn die Ressource erstellt wird, und kann mithilfe der SetClusterResourceName-Funktion geändert werden.

[in] dwDesiredAccess

Die angeforderten Zugriffsberechtigungen. Dies kann eine beliebige Kombination aus GENERIC_READ (0x80000000), GENERIC_ALL (0x10000000) oder MAXIMUM_ALLOWED (0x02000000) sein. Wenn dieser Wert null (0) ist, wird möglicherweise ein undefinierter Fehler zurückgegeben. Die Verwendung von GENERIC_ALL entspricht dem Aufrufen von OpenClusterResource.

[out, optional] lpdwGrantedAccess

Optionaler Parameter, der die Adresse eines DWORD enthält, das die gewährten Zugriffsrechte erhält. Wenn der DesiredAccess-ParameterMAXIMUM_ALLOWED (0x02000000) ist, enthält das DWORD , auf das dieser Parameter verweist, die maximalen Berechtigungen, die diesem Benutzer gewährt werden.

Rückgabewert

Wenn der Vorgang erfolgreich war, gibt OpenClusterResourceEx ein Handle an die geöffnete Ressource zurück.

Rückgabecode Beschreibung
NULL
 Der Vorgang war nicht erfolgreich. Rufen Sie die GetLastError-Funktion auf, um weitere Informationen zum Fehler zu erhalten. Wenn der Zielserver die OpenClusterResourceEx-Funktion nicht unterstützt (z. B. wenn auf dem Zielserver Windows Server 2008 oder früher ausgeführt wird), gibt die GetLastError-FunktionRPC_S_PROCNUM_OUT_OF_RANGE (1745) zurück.

Anforderungen

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

Weitere Informationen

CloseClusterResource

Failoverclusterressourcenverwaltungsfunktionen

OpenClusterResource