Fonction ClusterResourceTypeControlAsUser (clusapi.h)

Article
08/22/2023

Lance une opération affectant un type de ressource.

L’opération effectuée dépend du code de contrôle passé au paramètre dwControlCode .

Syntaxe

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
);

Paramètres

[in] hCluster

Gérez le cluster contenant le type de ressource identifié dans lpszResourceTypeName.

[in] lpszResourceTypeName

Pointeur vers une chaîne Unicode terminée par null contenant le nom du type de ressource à affecter.

[in, optional] hHostNode

Gérez le nœud hébergeant le type de ressource affecté.

[in] dwControlCode

Code de contrôle des ressources, énuméré par l’énumération CLUSCTL_RESOURCE_TYPE_CODES , spécifiant l’opération à effectuer. Pour connaître la syntaxe associée à un code de contrôle, reportez-vous au lien dans la rubrique CLUSCTL_RESOURCE_TYPE_CODES .

[in, optional] lpInBuffer

Pointeur vers la mémoire tampon d’entrée avec les informations nécessaires pour l’opération ou NULL si aucune information n’est nécessaire.

[in] nInBufferSize

Nombre d’octets dans la mémoire tampon pointée vers lpInBuffer.

[out, optional] lpOutBuffer

Pointeur vers la mémoire tampon de sortie avec des informations résultant de l’opération, ou NULL si rien n’est retourné.

[in] nOutBufferSize

Nombre d’octets dans la mémoire tampon de sortie pointée vers lpOutBuffer, ou zéro si l’appelant ne sait pas combien de données seront retournées.

[out, optional] lpBytesReturned

Pointeur vers le nombre d’octets dans la mémoire tampon pointée par lpOutBuffer qui ont été effectivement renseignés à la suite de l’opération. L’appelant peut passer la valeur NULL pour lpBytesReturned si ClusterResourceTypeControl n’a pas besoin de renvoyer le nombre d’octets dans la mémoire tampon de sortie.

Valeur retournée

La fonction retourne l’une des valeurs suivantes.

Code de retour	Description
ERROR_SUCCESS	L'opération a réussi. Si l’opération nécessitait une mémoire tampon de sortie, lpBytesReturned (s’il n’est pas NULL en entrée) pointe vers la taille réelle des données retournées dans la mémoire tampon.
ERROR_MORE_DATA	La mémoire tampon de sortie pointée par lpOutBuffer n’était pas assez grande pour contenir les données résultant de l’opération. Le paramètre lpBytesReturned (s’il n’est pas NULL en entrée) pointe vers la taille requise pour la mémoire tampon de sortie. Seules les opérations nécessitant une mémoire tampon de sortie retournent ERROR_MORE_DATA. Si le paramètre lpOutBuffer a la valeur NULL et que le paramètre nOutBufferSize a la valeur zéro, ERROR_SUCCESS peut être retourné, et non ERROR_MORE_DATA.
Code d’erreur système	L’opération n’a pas réussi. Si l’opération nécessite une mémoire tampon de sortie, la valeur spécifiée par lpBytesReturned n’est pas fiable.

Remarques

Lorsque ClusterResourceTypeControl retourne ERROR_MORE_DATA, définissez nOutBufferSize sur le nombre d’octets pointés par lpBytesReturned, puis appelez à nouveau la fonction.

Ne passez pas de handles LPC et RPC au même appel de fonction. Sinon, l’appel déclenche une exception RPC et peut avoir des effets destructeurs supplémentaires. Pour plus d’informations sur la création des handles LPC et RPC, consultez Handles LPC et RPC et OpenCluster.

ClusterResourceTypeControl est l’une des fonctions de code de contrôle. Pour plus d’informations sur les codes de contrôle et les fonctions de code de contrôle, consultez Utilisation de codes de contrôle.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2016
Plateforme cible	Windows
En-tête	clusapi.h
Bibliothèque	ClusAPI.lib
DLL	ClusAPI.dll

Voir aussi

OpenCluster

Codes de contrôle de type de ressource

Partager via