Fonction ResUtilGetResourceDependentIPAddressProps (resapi.h)

Article
03/04/2024

Récupère les propriétés privées de la première dépendance d’adresse IP trouvée pour une ressource spécifiée. Le type PRESUTIL_GET_RESOURCE_DEPENDENTIP_ADDRESS_PROPS définit un pointeur vers cette fonction.

Syntaxe

DWORD ResUtilGetResourceDependentIPAddressProps(
  [in]      HRESOURCE hResource,
  [out]     LPWSTR    pszAddress,
  [in, out] DWORD     *pcchAddress,
  [out]     LPWSTR    pszSubnetMask,
  [in, out] DWORD     *pcchSubnetMask,
  [out]     LPWSTR    pszNetwork,
  [in, out] DWORD     *pcchNetwork
);

Paramètres

[in] hResource

Gérez la ressource pour interroger les dépendances.

[out] pszAddress

Mémoire tampon de sortie pour le retour de la valeur de la propriété privée Address .

[in, out] pcchAddress

Lors de l’entrée, spécifie la taille de la mémoire tampon pszAddress en tant que nombre de WCHAR. Lors de la sortie, spécifie la taille des données résultantes sous la forme d’un nombre de WCHARqui inclut la valeur NULL de fin.

[out] pszSubnetMask

Mémoire tampon de sortie pour renvoyer la valeur de la propriété privée SubnetMask .

[in, out] pcchSubnetMask

Lors de l’entrée, spécifie la taille de la mémoire tampon pszSubnetMask en tant que nombre de WCHAR. Lors de la sortie, spécifie la taille des données résultantes sous la forme d’un nombre de WCHARqui inclut la valeur NULL de fin.

[out] pszNetwork

Mémoire tampon de sortie pour retourner la valeur de la propriété privée Réseau .

[in, out] pcchNetwork

Lors de l’entrée, spécifie la taille de la mémoire tampon pszNetwork sous la forme d’un nombre de WCHAR. Lors de la sortie, spécifie la taille des données résultantes sous la forme d’un nombre de WCHARqui inclut la valeur NULL de fin.

Windows Server 2008 R2 et Windows Server 2008 : Ce paramètre est nommé pcch avant Windows Server 2012.

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_SUCCESS (0).

Si l’opération échoue, la fonction retourne un code d’erreur système. Voici les codes d’erreur possibles.

Code/valeur de retour	Description
ERROR_NO_MORE_ITEMS 259 (0x103)	Aucune dépendance d’adresse IP n’a été trouvée dans la liste des dépendances de la ressource spécifiée.
ERROR_RESOURCE_NOT_PRESENT 4316 (0x10DC)	Aucune dépendance d’adresse IP n’a été trouvée.
ERROR_MORE_DATA 234 (0xEA)	La taille de l’une des mémoires tampons était trop petite pour contenir les données résultantes.

Remarques

N’appelez pas ResUtilGetResourceDependentIPAddressProps à partir d’une fonction de point d’entrée DLL de ressource. ResUtilGetResourceDependentIPAddressProps peut être appelé en toute sécurité à partir d’un thread de travail. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.

La fonction ResUtilGetResourceDependentIPAddressProps retourne uniquement les propriétés privées de la première ressource IPv4 dont dépend directement la ressource. La fonction n’examine pas les dépendances indirectes (telles qu’une ressource qui dépend d’une ressource nom réseau qui à son tour dépend d’une ressource d’adresse IP ), de ressources d’adresse IPv6 ou de ressources d’adresse de tunnel IPv6 .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 Entreprise, Windows Server 2008 Datacenter
Plateforme cible	Windows
En-tête	resapi.h
Bibliothèque	ResUtils.lib
DLL	ResUtils.dll