Função ADsBuildVarArrayStr (adshlp.h)

A função ADsBuildVarArrayStr cria uma matriz variante de uma matriz de cadeias de caracteres Unicode.

Sintaxe

HRESULT ADsBuildVarArrayStr(
  [in]  LPWSTR  *lppPathNames,
  [in]  DWORD   dwPathNames,
  [out] VARIANT *pVar
);

Parâmetros

[in] lppPathNames

Tipo: LPWSTR*

Matriz de cadeias de caracteres Unicode terminadas em nulo.

[in] dwPathNames

Tipo: DWORD

Número de entradas Unicode na matriz fornecida.

[out] pVar

Tipo: VARIANT*

Ponteiro para a matriz variante resultante.

Retornar valor

Tipo: HRESULT

Esse método dá suporte aos valores retornados padrão, bem como aos seguintes.

Para obter mais informações sobre outros valores retornados, consulte Códigos de erro ADSI.

Comentários

Para dar suporte à Automação, use a função ADsBuildVarArrayStr para converter cadeias de caracteres Unicode em uma matriz variante de cadeias de caracteres.

Exemplos

O exemplo de código a seguir mostra como usar a função ADsBuildVarArrayStr para converter nomes de classe de objeto de cadeias de caracteres Unicode em uma matriz variante de cadeias de caracteres.

HRESULT EnumObject(LPWSTR pszADsPath,
                   LPWSTR * lppClsNames,
                   DWORD dwClsNames)
{
    ULONG ulFetched = 0L;
    IEnumVARIANT * pEnumVar = NULL;
    VARIANT varFilter, varArray[MAX_ADS_ENUM];
    HRESULT hr;
    IADsContainer * pADsContainer = NULL;
    DWORD dwObjects = 0, dwEnumCount=0, i=0;
    BSTR bstrName;
    BOOL fContinue=TRUE;
 
    hr = ADsGetObject(pszADsPath,
                     IID_IADsContainer,
                     (void**)&pADsContainer);
    if (FAILED(hr)) goto cleanup;
 
    // Create a string array of class names as search filters.
    VariantInit(&varFilter);
    hr = ADsBuildVarArrayStr(lppClsNames, dwClsNames, &varFilter);
    if (FAILED(hr)) goto cleanup;
 
    // Apply filters to objects in the container.
    hr = pADsContainer->put_Filter(varFilter);
    if(FAILED(hr)) goto cleanup;
 
    // Create an enumerator.
    hr = ADsBuildEnumerator(pADsContainer, &pEnumVar);
    if(FAILED(hr)) goto cleanup;
 
    // Enumerate the objects and print the names.
    while(fContinue) {
        IADs* pObject;
        hr = ADsEnumerateNext(pEnumVar, MAX_ADS_ENUM,
                            varArray, &ulFetched);
        if(hr == S_FALSE) fContinue = FALSE;
        dwEEnumCount++;
 
        for (i=0; i<ulFetched; i++) {
            IDispatch *pDispatch = NULL;
            pDispatch = varArray[I].pDispVal;
            hr = pDispatch->QueryInterface(IID_IADs,
                                        (void**) &pObject);
            if (FAILED(hr)) goto cleanup;
 
            hr = pObject->get_Name(&bstrName);
            if(FAILED(hr)) goto cleanup;
            printf(" Object name: %S\n",bstrName);
 
            // Release the ADSI object.
            SysFreeString(bstrname);
            pObject->Release();
            pDispatch->Release();
        }
        memset(varArray, 0, sizeof(VARIANT)*MAX_ADS_ENUM);
        dwObjects += ulFetched;
    }
    hr = S_OK;
 
cleanup:
    if(bstrName) SysFreeString(bstrName);
    if(pEnumvar) ADsFreeEnumerator(pEnumVar);
    if(pADsContainer) pADsContainer->Release();
 
    return (hr);
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	adshlp.h
Biblioteca	Activeds.lib
DLL	Activeds.dll

Confira também

Códigos de erro ADSI

Funções ADSI

ADsBuildVarArrayInt