Funzione ClusterResourceTypeControlAsUser (clusapi.h)

Articolo
08/22/2023

Avvia un'operazione che influisce su un tipo di risorsa.

L'operazione eseguita dipende dal codice di controllo passato al parametro dwControlCode .

Sintassi

DWORD ClusterResourceTypeControlAsUser(
  [in]            HCLUSTER hCluster,
  [in]            LPCWSTR  lpszResourceTypeName,
  [in, optional]  HNODE    hHostNode,
  [in]            DWORD    dwControlCode,
  [in, optional]  LPVOID   lpInBuffer,
  [in]            DWORD    nInBufferSize,
  [out, optional] LPVOID   lpOutBuffer,
  [in]            DWORD    nOutBufferSize,
  [out, optional] LPDWORD  lpBytesReturned
);

Parametri

[in] hCluster

Handle nel cluster contenente il tipo di risorsa identificato in lpszResourceTypeName.

[in] lpszResourceTypeName

Puntatore a una stringa Unicode con terminazione NULL contenente il nome del tipo di risorsa da interessare.

[in, optional] hHostNode

Gestire nel nodo che ospita il tipo di risorsa interessato.

[in] dwControlCode

Codice di controllo delle risorse, enumerato dall'enumerazione CLUSCTL_RESOURCE_TYPE_CODES , specificando l'operazione da eseguire. Per la sintassi associata a un codice di controllo, fare riferimento al collegamento nell'argomento CLUSCTL_RESOURCE_TYPE_CODES .

[in, optional] lpInBuffer

Puntatore al buffer di input con informazioni necessarie per l'operazione o NULL se non sono necessarie informazioni.

[in] nInBufferSize

Numero di byte nel buffer a cui punta lpInBuffer.

[out, optional] lpOutBuffer

Puntatore al buffer di output con informazioni risultanti dall'operazione o NULL se non verrà restituito nulla.

[in] nOutBufferSize

Numero di byte nel buffer di output a cui punta lpOutBuffer o zero se il chiamante non conosce la quantità di dati restituiti.

[out, optional] lpBytesReturned

Puntatore al numero di byte nel buffer a cui punta lpOutBuffer che sono stati effettivamente compilati come risultato dell'operazione. Il chiamante può passare NULL per lpBytesReturned se ClusterResourceTypeControl non deve passare il numero di byte nel buffer di output.

Valore restituito

La funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
ERROR_SUCCESS	L'operazione è stata completata. Se l'operazione richiede un buffer di output, lpBytesReturned (se non NULL in input) punta alle dimensioni effettive dei dati restituiti nel buffer.
ERROR_MORE_DATA	Il buffer di output a cui fa riferimento lpOutBuffer non era abbastanza grande per contenere i dati risultanti dall'operazione. Il parametro lpBytesReturned (se non NULL in input) punta alle dimensioni necessarie per il buffer di output. Solo le operazioni che richiedono una restituzione del buffer di output ERROR_MORE_DATA. Se il parametro lpOutBuffer è NULL e il parametro nOutBufferSize è zero, ERROR_SUCCESS può essere restituito, non ERROR_MORE_DATA.
Codice errore di sistema	L'operazione non ha avuto esito positivo. Se l'operazione richiede un buffer di output, il valore specificato da lpBytesReturned non è attendibile.

Commenti

Quando ClusterResourceTypeControl restituisce ERROR_MORE_DATA, impostare nOutBufferSize sul numero di byte puntati da lpBytesReturned e chiamare nuovamente la funzione.

Non passare i handle LPC e RPC alla stessa chiamata di funzione. In caso contrario, la chiamata genererà un'eccezione RPC e può avere effetti distruttivi aggiuntivi. Per informazioni sulla creazione degli handle LPC e RPC, vedere Handle LPC e RPC e OpenCluster.

ClusterResourceTypeControl è una delle funzioni del codice di controllo. Per altre informazioni sui codici di controllo e sulle funzioni di codice di controllo, vedere Uso dei codici di controllo.

Requisiti

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

Vedi anche

OpenCluster

Codici di controllo tipo di risorsa

Condividi tramite