Función ResUtilGetResourceDependentIPAddressProps (resapi.h)

Artículo
08/25/2023

Recupera las propiedades privadas de la primera dependencia de dirección IP encontrada para un recurso especificado. El tipo PRESUTIL_GET_RESOURCE_DEPENDENTIP_ADDRESS_PROPS define un puntero a esta función.

Sintaxis

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

Parámetros

[in] hResource

Controle el recurso para consultar las dependencias.

[out] pszAddress

Búfer de salida para devolver el valor de la propiedad privada Address .

[in, out] pcchAddress

En la entrada, especifica el tamaño del búfer pszAddress como recuento de WCHARs. En la salida, especifica el tamaño de los datos resultantes como un recuento de WCHARs que incluye el valor NULL de terminación.

[out] pszSubnetMask

Búfer de salida para devolver el valor de la propiedad privada SubnetMask .

[in, out] pcchSubnetMask

En la entrada, especifica el tamaño del búfer pszSubnetMask como recuento de WCHARs. En la salida, especifica el tamaño de los datos resultantes como un recuento de WCHARs que incluye el valor NULL de terminación.

[out] pszNetwork

Búfer de salida para devolver el valor de la propiedad privada Network .

[in, out] pcchNetwork

En la entrada, especifica el tamaño del búfer pszNetwork como recuento de WCHARs. En la salida, especifica el tamaño de los datos resultantes como un recuento de WCHARs que incluye el valor NULL de terminación.

Windows Server 2008 R2 y Windows Server 2008: Este parámetro se denomina pcch antes de Windows Server 2012.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve ERROR_SUCCESS (0).

Si se produce un error en la operación, la función devuelve un código de error del sistema. A continuación se muestran códigos de error posibles.

Código o valor devuelto	Descripción
ERROR_NO_MORE_ITEMS 259 (0x103)	No se encontró ninguna dependencia de dirección IP en la lista de dependencias del recurso especificado.
ERROR_RESOURCE_NOT_PRESENT 4316 (0x10DC)	No se encontró ninguna dependencia de dirección IP.
ERROR_MORE_DATA 234 (0xEA)	El tamaño de uno de los búferes era demasiado pequeño para contener los datos resultantes.

Comentarios

No llame a ResUtilGetResourceDependentIPAddressProps desde cualquier función de punto de entrada dll de recursos. ResUtilGetResourceDependentIPAddressProps se puede llamar de forma segura desde un subproceso de trabajo. Para obtener más información, consulte Llamadas de función para evitar en archivos DLL de recursos.

La función ResUtilGetResourceDependentIPAddressProps devuelve solo las propiedades privadas del primer recurso IPv4 del que depende directamente el recurso. La función no examina las dependencias indirectas (como un recurso que depende de un recurso de nombre de red que, a su vez, depende de un recurso de dirección IP ), recursos de dirección IPv6 o recursos de dirección de túnel IPv6 .

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino	Windows
Encabezado	resapi.h
Library	ResUtils.lib
Archivo DLL	ResUtils.dll