WPRCCreateInstanceUnderInstanceName

Essa função cria uma instância de uma classe especificada, com a opção de especificar o nome da instância.

Sintaxe

HRESULT WPRCCreateInstanceUnderInstanceName(
    _In_opt_ BSTR bstrInstanceName,
    _In_ REFCLSID rclsid,
    _In_opt_ LPUNKNOWN pUnkOuter,
    _In_ DWORD dwClsContext,
    _In_ REFIID riid,
    _Outptr_ LPVOID *ppv
);

Parâmetros

bstrInstanceName

(In_opt BSTR): opcional. O nome da instância. Se esse parâmetro for NULL, a função criará uma instância sem nome.

rclsid

(Em REFCLSID): o CLSID associado aos dados e ao código que serão usados para criar o objeto.

pUnkOuter

(In_opt LPUNKNOWN): opcional. Se NULL, o objeto não está sendo criado como parte de uma agregação. Se não for NULL, ponteiro para a interface IUnknown do objeto agregado (o IUnknown de controle).

dwClsContext

(Em DWORD): contexto no qual o código que gerencia o objeto recém-criado será executado. Os valores são obtidos da classe de enumeração CLSCTX.

riid

(In REFIID): é uma referência ao identificador da interface a ser usada para a comunicação com o objeto.

ppv

(Outptr LPVOID): endereço da variável de ponteiro que recebe o ponteiro de interface solicitado em riid. Após um retorno bem-sucedido, *ppv contém o ponteiro de interface solicitado.

Valor de retorno

A função retorna um código HRESULT. Uma execução bem-sucedida é normalmente indicada por S_OK. Uma falha é indicada por qualquer outro código HRESULT, o que significa que ocorreu um erro durante a execução da função.

Comentários

Tópicos relacionados

Funções