Funzione ClusterResourceControlAsUser (clusapi.h)
Avvia un'operazione che influisce su una risorsa.
L'operazione eseguita dipende dal codice di controllo passato al parametro dwControlCode .
Sintassi
DWORD ClusterResourceControlAsUser(
[in] HRESOURCE hResource,
[in, optional] HNODE hHostNode,
[in] DWORD dwControlCode,
[in, optional] LPVOID lpInBuffer,
[in] DWORD cbInBufferSize,
[out, optional] LPVOID lpOutBuffer,
[in] DWORD cbOutBufferSize,
[out, optional] LPDWORD lpBytesReturned
);
Parametri
[in] hResource
Gestire la risorsa da interessare.
[in, optional] hHostNode
Handle facoltativo nel nodo per eseguire l'operazione. Se NULL, il nodo proprietario della risorsa identificata da hResource esegue l'operazione.
[in] dwControlCode
Codice di controllo delle risorse, enumerato dall'enumerazione CLUSCTL_RESOURCE_CODES , specificando l'operazione da eseguire. Per la sintassi associata a un codice di controllo, fare riferimento a
collegamento nell'argomento CLUSCTL_RESOURCE_CODES .
[in, optional] lpInBuffer
Puntatore a un buffer di input contenente informazioni necessarie per l'operazione o NULL se non sono necessarie informazioni.
[in] cbInBufferSize
Dimensione allocata (in byte) del buffer di input.
[out, optional] lpOutBuffer
Puntatore a un buffer di output per ricevere i dati risultanti dall'operazione o NULL se non verranno restituiti dati.
[in] cbOutBufferSize
Dimensione allocata (in byte) del buffer di output.
[out, optional] lpBytesReturned
Restituisce le dimensioni effettive (in byte) dei dati risultanti dall'operazione. Se queste informazioni non sono necessarie, passare NULL per lpBytesReturned.
Valore restituito
La funzione restituisce uno dei valori seguenti.
| Codice/valore restituito | Descrizione |
|---|---|
|
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. |
|
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 cbOutBufferSize è zero, ERROR_SUCCESS può essere restituito, non ERROR_MORE_DATA. |
|
Si applica solo a CLUSCTL_RESOURCE_SET_COMMON_PROPERTIES e CLUSCTL_RESOURCE_SET_PRIVATE_PROPERTIES. Indica che le proprietà sono state archiviate correttamente, ma non sono ancora state applicate alla risorsa. Le nuove proprietà avranno effetto dopo che la risorsa viene presa offline e nuovamente visualizzata online. |
|
Il nodo specificato dal parametro hNode non è il nodo proprietario della risorsa specificata da hResource. |
| L'operazione non ha avuto esito positivo. Se l'operazione richiede un buffer di output, il valore specificato da lpBytesReturned (se non NULL in input) non è attendibile. |
Commenti
Quando ClusterResourceControl restituisce ERROR_MORE_DATA, impostare cbOutBufferSize 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.
La funzione ClusterResourceControl è 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 |