Structure ADSPROPINITPARAMS (adsprop.h)

La structure ADSPROPINITPARAMS est utilisée avec la fonction ADsPropGetInitInfo pour obtenir les données d’objet auxquelles s’applique un spécificateur d’affichage.

Syntaxe

typedef struct _ADSPROPINITPARAMS {
  DWORD            dwSize;
  DWORD            dwFlags;
  HRESULT          hr;
  IDirectoryObject *pDsObj;
  LPWSTR           pwzCN;
  PADS_ATTR_INFO   pWritableAttrs;
} ADSPROPINITPARAMS, *PADSPROPINITPARAMS;

Membres

dwSize

Taille, en octets, de la structure ADSPROPINITPARAMS . Définissez cette valeur avant d’appeler ADsPropGetInitInfo.

dwFlags

Réservé.

hr

Contient une valeur HRESULT qui spécifie le résultat de l’opération bind/get. Si cette valeur n’est pas égale à S_OK, les membres de structure restants ne sont pas initialisés et doivent être ignorés.

pDsObj

Pointeur vers une interface IDirectoryObject qui représente l’objet de répertoire auquel s’applique le spécificateur d’affichage. Ne libérez pas cette interface.

pwzCN

Pointeur vers une chaîne Unicode terminée par null qui contient le nom commun de l’objet de répertoire.

pWritableAttrs

Pointeur vers une structure ADS_ATTR_INFO qui contient des données d’attribut pour l’objet répertoire.

Remarques

La fonction ADsPropGetInitInfo alloue de la mémoire pour les membres pwzCN et pWritableAttrs . Cette mémoire est libérée par le système une fois que tous les objets de spécificateur d’affichage sont détruits. Le nombre de références pour le pointeur d’interface dans pDsObj n’est pas incrémenté en appelant ADsPropGetInitInfo. L’interface ne doit donc pas être libérée par l’appelant.

Configuration requise

Voir aussi

ADS_ATTR_INFO

ADsPropGetInitInfo

IDirectoryObject