IADsAccessControlList::get__NewEnum-Methode (iads.h)
Die IADsAccessControlList::get__NewEnum-Methode wird verwendet, um ein Enumeratorobjekt für die ACL zum Aufzählen von ACEs abzurufen.
Syntax
HRESULT get__NewEnum(
[out] IUnknown **retval
);
Parameter
[out] retval
Zeiger auf den Zeiger auf die IUnknown-Schnittstelle , die zum Abrufen der IEnumVARIANT-Schnittstelle für ein Enumeratorobjekt für die ACL verwendet wird.
Rückgabewert
Diese Methode gibt die Standardrückgabewerte zurück, einschließlich S_OK und E_FAIL. Weitere Informationen zu anderen Rückgabewerten finden Sie unter ADSI-Fehlercodes.
Hinweise
Beachten Sie, dass in get__NewEnum zwei Unterstriche vorhanden sind.
Beispiele
Im folgenden Codebeispiel wird bei der Ausführung der For Each-Schleife ein impliziter Aufruf der get__NewEnum-Methode ausgeführt.
Dim Dacl As IADsAccessControlList
Dim ace As IADsAccessControlEntry
On Error GoTo Cleanup
' Get DACL. Code omitted.
' Display the trustees for each of the ACEs
For Each ace In Dacl
Debug.Print ace.trustee
Next ace
Cleanup:
If (Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set Dacl = Nothing
Set ace = Nothing
Im folgenden Codebeispiel wird gezeigt, wie ACEs mithilfe von IADsAccessControlList::get__NewEnum aufgezählt werden.
HRESULT ListTrustees(IADsAccessControlList *pACL)
{
IEnumVARIANT *pEnum = NULL;
LPUNKNOWN pUnk = NULL;
ULONG lFetch = 0;
BSTR bstr = NULL;
IADsAccessControlEntry *pACE = NULL;
IDispatch *pDisp = NULL;
VARIANT var;
HRESULT hr = S_OK;
VariantInit(&var);
hr = pACL->get__NewEnum(&pUnk);
if (FAILED(hr)){goto Cleanup;}
hr = pUnk->QueryInterface( IID_IEnumVARIANT, (void**) &pEnum );
pUnk->Release();
if (FAILED(hr)){goto Cleanup;}
hr = pEnum->Next( 1, &var, &lFetch );
if (FAILED(hr)){goto Cleanup;}
while( hr == S_OK )
{
if ( lFetch == 1 )
{
if ( VT_DISPATCH != V_VT(&var) )
{
goto Cleanup;
}
pDisp = V_DISPATCH(&var);
/////////////////////////
// Get the individual ACE
/////////////////////////
hr = pDisp->QueryInterface( IID_IADsAccessControlEntry,(void**)&pACE );
if ( SUCCEEDED(hr) )
{
pACE->get_Trustee(&bstr);
printf("\n %S:\n", bstr);
//ACE manipulation here
SysFreeString(bstr);
pACE->Release();
}
pACE->Release();
pDisp->Release();
VariantClear(&var);
}
hr = pEnum->Next( 1, &var, &lFetch );
}
Cleanup:
if(pEnum) pEnum->Release();
if(pUnk) pUnk->Release();
if(bstr) SysFreeString(bstr);
if(pACE) pACE->Release();
VariantClear(&var);
return hr;
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |
| DLL | Activeds.dll |