Estrutura ADSPROPINITPARAMS (adsprop.h)
A estrutura ADSPROPINITPARAMS é usada com a função ADsPropGetInitInfo para obter dados de objeto aos quais um especificador de exibição se aplica.
Sintaxe
typedef struct _ADSPROPINITPARAMS {
DWORD dwSize;
DWORD dwFlags;
HRESULT hr;
IDirectoryObject *pDsObj;
LPWSTR pwzCN;
PADS_ATTR_INFO pWritableAttrs;
} ADSPROPINITPARAMS, *PADSPROPINITPARAMS;
Membros
dwSize
O tamanho, em bytes, da estrutura ADSPROPINITPARAMS . Defina esse valor antes de chamar ADsPropGetInitInfo.
dwFlags
Reservado.
hr
Contém um valor HRESULT que especifica o resultado da operação de associação/obtenção. Se esse valor não for igual a S_OK, os membros restantes da estrutura não serão inicializados e deverão ser ignorados.
pDsObj
Ponteiro para uma interface IDirectoryObject que representa o objeto de diretório ao qual o especificador de exibição se aplica. Não libere essa interface.
pwzCN
Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o nome comum do objeto de diretório.
pWritableAttrs
Ponteiro para uma estrutura ADS_ATTR_INFO que contém dados de atributo para o objeto de diretório.
Comentários
A função ADsPropGetInitInfo aloca memória para os membros pwzCN e pWritableAttrs . Essa memória é liberada pelo sistema depois que todos os objetos do especificador de exibição são destruídos. A contagem de referência para o ponteiro de interface em pDsObj não é incrementada chamando ADsPropGetInitInfo, portanto, a interface não deve ser liberada pelo chamador.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Cabeçalho | adsprop.h |