ADsPropGetInitInfo-Funktion (adsprop.h)
Die ADsPropGetInitInfo-Funktion wird verwendet, um Verzeichnisobjektdaten abzurufen, für die eine Active Directory Domain Services-Eigenschaftenblatterweiterung gilt.
Syntax
BOOL ADsPropGetInitInfo(
[in] HWND hNotifyObj,
[out] PADSPROPINITPARAMS pInitParams
);
Parameter
[in] hNotifyObj
Das Handle des Benachrichtigungsobjekts. Um dieses Handle zu erhalten, rufen Sie ADsPropCreateNotifyObj auf.
[out] pInitParams
Zeiger auf eine ADSPROPINITPARAMS-Struktur , die die Verzeichnisobjektdaten empfängt. Das dwSize-Element dieser Struktur muss vor dem Aufrufen dieser Funktion eingegeben werden.
Rückgabewert
Gibt nonzero zurück, wenn der Vorgang erfolgreich war oder andernfalls null.
Hinweise
Der Arbeitsspeicher für die Elemente pwzCN und pWritableAttrs wird von der Funktion ADsPropGetInitInfo zugewiesen. Dieser Arbeitsspeicher wird vom System freigegeben, nachdem alle Eigenschaftenblattobjekte zerstört wurden. Die Referenzanzahl für den Schnittstellenzeiger in pDsObj wird durch aufrufen von ADsPropGetInitInfo nicht erhöht, sodass die Schnittstelle nicht vom Aufrufer freigegeben werden darf.
Bei Eigenschaftenblättern mit mehrfacher Auswahl bindet das System nur an das erste Objekt im DSOBJECT-Array . Aus diesem Grund stellt ADsPropGetInitInfo nur die Attribute IDirectoryObject und beschreibbare Attribute für das erste Objekt im Array bereit. Die anderen Objekte im Array sind nicht an sie gebunden.
Beispiele
Im folgenden Codebeispiel wird die Verwendung der Funktion ADsPropGetInitInfo veranschaulicht.
HRESULT GetADsPageInfo(HWND hwndNotifyObject, ADSPROPINITPARAMS *pip)
{
if((NULL == pip) || (!IsWindow(hwndNotifyObject)))
{
return E_INVALIDARG;
}
ADSPROPINITPARAMS InitParams;
InitParams.dwSize = sizeof(ADSPROPINITPARAMS);
if(ADsPropGetInitInfo(hwndNotifyObject, &InitParams))
{
*pip = InitParams;
return InitParams.hr;
}
return E_FAIL;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | adsprop.h |
| Bibliothek | Dsprop.lib |
| DLL | Dsprop.dll |