ADSPROPINITPARAMS-Struktur (adsprop.h)

Die ADSPROPINITPARAMS-Struktur wird zusammen mit der Funktion ADsPropGetInitInfo verwendet, um Objektdaten abzurufen, auf die ein Anzeigespezifizierer angewendet wird.

Syntax

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

Member

dwSize

Die Größe der ADSPROPINITPARAMS-Struktur in Bytes. Legen Sie diesen Wert fest, bevor Sie ADsPropGetInitInfo aufrufen.

dwFlags

Reserviert.

hr

Enthält einen HRESULT-Wert , der das Ergebnis des Bind/Get-Vorgangs angibt. Wenn dieser Wert nicht gleich S_OK ist, werden die verbleibenden Strukturmember nicht initialisiert und sollten ignoriert werden.

pDsObj

Zeiger auf eine IDirectoryObject-Schnittstelle , die das Verzeichnisobjekt darstellt, auf das der Anzeigebezeichner angewendet wird. Lassen Sie diese Schnittstelle nicht frei.

pwzCN

Zeiger auf eine Unicode-Zeichenfolge mit Null-Endung, die den allgemeinen Namen des Verzeichnisobjekts enthält.

pWritableAttrs

Zeiger auf eine ADS_ATTR_INFO-Struktur , die Attributdaten für das Verzeichnisobjekt enthält.

Hinweise

Die Funktion ADsPropGetInitInfo ordnet Arbeitsspeicher für die Elemente pwzCN und pWritableAttrs zu. Dieser Arbeitsspeicher wird vom System freigegeben, nachdem alle Anzeigespezifiziererobjekte zerstört wurden. Die Verweisanzahl für den Schnittstellenzeiger in pDsObj wird durch Aufrufen von ADsPropGetInitInfo nicht erhöht, sodass die Schnittstelle nicht vom Aufrufer freigegeben werden darf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Kopfzeile	adsprop.h

Weitere Informationen

ADS_ATTR_INFO

ADsPropGetInitInfo

IDirectoryObject