Condividi tramite


Funzione ClusterRegOpenKey (clusapi.h)

Apre una chiave di database del cluster esistente.

Sintassi

LONG ClusterRegOpenKey(
  [in]  HKEY    hKey,
  [in]  LPCWSTR lpszSubKey,
  [in]  REGSAM  samDesired,
  [out] PHKEY   phkResult
);

Parametri

[in] hKey

Gestire in una chiave attualmente aperta. Questo parametro non può essere NULL.

[in] lpszSubKey

Puntatore a una stringa Unicode con terminazione null specificando il nome della sottochiave da creare o aprire. Il parametro lpszSubKey deve puntare a una sottochiave che:

  • Chiave figlio della chiave identificata da hKey.
  • Non deve iniziare con il carattere della barra rovesciata ( \ ).
  • Non deve essere NULL.
Il parametro lpszSubKey può puntare a una stringa vuota, causando la restituzione di un handle alla chiave di database rappresentata da hKey.

[in] samDesired

Maschera di accesso che specifica l'accesso alla sicurezza necessario per la nuova chiave.

[out] phkResult

Puntatore a un handle per la chiave aperta o creata.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce ERROR_SUCCESS.

Se l'operazione ha esito negativo, la funzione restituisce un codice di errore di sistema.

Commenti

I chiamanti devono chiamare ClusterRegCloseKey per chiudere l'handle della chiave aperto da ClusterRegOpenKey al termine dell'operazione.

Requisiti

Requisito Valore
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione Windows
Intestazione clusapi.h
Libreria ClusAPI.lib
DLL ClusAPI.dll

Vedi anche

ClusterRegCloseKey

ClusterRegCreateKey