Uppräkningshjälpfunktioner
Det finns tre uppräkningshjälpfunktioner som kan användas från C/C++ för att underlätta navigeringen av Active Directory-objekt. De är ADsBuildEnumerator, ADsEnumerateNextoch ADsFreeEnumerator.
ADsBuildEnumerator
Hjälpfunktionen ADsBuildEnumerator kapslar in koden som krävs för att skapa ett uppräkningsobjekt. Den anropar metoden IADsContainer::get__NewEnum för att skapa ett uppräkningsobjekt och anropar sedan metoden QueryInterface för IUnknown för att hämta en pekare till IEnumVARIANT--gränssnittet för objektet. Uppräkningsobjektet är Automation-mekanismen för att räkna upp över containrar. Använd funktionen ADsFreeEnumerator för att släppa uppräkningsobjektet.
ADsEnumerateNext
Hjälpfunktionen ADsEnumerateNext fyller i en VARIANT-matris med element som hämtats från ett uppräkningsobjekt. Antalet element som hämtas kan vara mindre än det begärda antalet.
ADsFreeEnumerator
Frigör ett uppräkningsobjekt som tidigare skapats via funktionen ADsBuildEnumerator.
I följande kodexempel visas en funktion som använder uppräkningshjälpfunktioner i C++.
/*****************************************************************************
Function: TestEnumObject
Arguments: pszADsPath - ADsPath of the container to be enumerated (WCHAR*).
Return: S_OK if successful, an error code otherwise.
Purpose: Example using ADsBuildEnumerator, ADsEnumerateNext and
ADsFreeEnumerator.
******************************************************************************/
#define MAX_ENUM 100
HRESULT
TestEnumObject( LPWSTR pszADsPath )
{
ULONG cElementFetched = 0L;
IEnumVARIANT * pEnumVariant = NULL;
VARIANT VariantArray[MAX_ENUM];
HRESULT hr = S_OK;
IADsContainer * pADsContainer = NULL;
DWORD dwObjects = 0, dwEnumCount = 0, i = 0;
BOOL fContinue = TRUE;
hr = ADsGetObject(
pszADsPath,
IID_IADsContainer,
(void **)&pADsContainer
);
if (FAILED(hr)) {
printf("\"%S\" is not a valid container object.\n", pszADsPath) ;
goto exitpoint ;
}
hr = ADsBuildEnumerator(
pADsContainer,
&pEnumVariant
);
if( FAILED( hr ) )
{
printf("ADsBuildEnumerator failed with %lx\n", hr ) ;
goto exitpoint ;
}
fContinue = TRUE;
while (fContinue) {
IADs *pObject ;
hr = ADsEnumerateNext(
pEnumVariant,
MAX_ENUM,
VariantArray,
&cElementFetched
);
if ( FAILED( hr ) )
{
printf("ADsEnumerateNext failed with %lx\n",hr);
goto exitpoint;
}
if (hr == S_FALSE) {
fContinue = FALSE;
}
dwEnumCount++;
for (i = 0; i < cElementFetched; i++ ) {
IDispatch *pDispatch = NULL;
BSTR bstrADsPath = NULL;
pDispatch = VariantArray[i].pdispVal;
hr = V_DISPATCH( VariantArray + i )->QueryInterface(IID_IADs, (void **) &pObject) ;
if( SUCCEEDED( hr ) )
{
pObject->get_ADsPath( &bstrADsPath );
printf( "%S\n", bstrADsPath );
}
pObject->Release();
VariantClear( VariantArray + i );
SysFreeString( bstrADsPath );
}
dwObjects += cElementFetched;
}
printf("Total Number of Objects enumerated is %d\n", dwObjects);
exitpoint:
if (pEnumVariant) {
ADsFreeEnumerator( pEnumVariant );
}
if (pADsContainer) {
pADsContainer->Release();
}
return(hr);
}