Função ResUtilEnumProperties (resapi.h)

Enumera os nomes de propriedade de um objeto de cluster. O tipo PRESUTIL_ENUM_PROPERTIES define um ponteiro para essa função.

Sintaxe

DWORD ResUtilEnumProperties(
  [in]  const PRESUTIL_PROPERTY_ITEM pPropertyTable,
  [out] LPWSTR                       pszOutProperties,
  [in]  DWORD                        cbOutPropertiesSize,
  [out] LPDWORD                      pcbBytesReturned,
  [out] LPDWORD                      pcbRequired
);

Parâmetros

[in] pPropertyTable

Ponteiro para uma matriz de estruturas de RESUTIL_PROPERTY_ITEM que descrevem as propriedades a serem enumeradas.

[out] pszOutProperties

Ponteiro para o buffer de saída no qual retornar os nomes de todas as propriedades em vários formatos de cadeia de caracteres. Cada nome de propriedade é armazenado como uma cadeia de caracteres Unicode terminada em nulo. O nome da última propriedade é seguido por um caractere final de terminação nula.

[in] cbOutPropertiesSize

Tamanho em bytes do buffer de saída apontado por pszOutProperties.

[out] pcbBytesReturned

Ponteiro para o número total de bytes na lista de propriedades apontada por pszOutProperties.

[out] pcbRequired

Número de bytes necessários se o buffer de saída for muito pequeno.

Retornar valor

Se a operação for bem-sucedida, a função retornará ERROR_SUCCESS.

Se a operação falhar, a função retornará um código de erro do sistema. Veja a seguir possíveis códigos de erro.

Código de retorno	Descrição
ERROR_BAD_ARGUMENTS	Um ou mais dos parâmetros de entrada eram inválidos.
ERROR_NOT_ENOUGH_MEMORY	Erro ao alocar memória.
ERROR_MORE_DATA	O tamanho do buffer de saída é muito pequeno para conter os dados resultantes. O parâmetro pcbRequired aponta para o tamanho correto.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de Destino	Windows
Cabeçalho	resapi.h
Biblioteca	ResUtils.lib
DLL	ResUtils.dll

Confira também

RESUTIL_PROPERTY_ITEM