Método IClassFactory2::RequestLicKey (ocidl.h)

  • Artigo

Cria uma chave de licença que o chamador pode salvar e usar posteriormente para criar uma instância do objeto licenciado.

Sintaxe

HRESULT RequestLicKey(
  [in]  DWORD dwReserved,
  [out] BSTR  *pBstrKey
);

Parâmetros

[in] dwReserved

Esse parâmetro é reservado e precisa ser zero.

[out] pBstrKey

Um ponteiro para a variável alocada pelo chamador que recebe a chave de licença alocada pelo computador chamado no retorno bem-sucedido desse método. Esse parâmetro é definido como NULL em qualquer falha.

Retornar valor

Esse método pode retornar os valores retornados padrão E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 A chave de licença foi criada com êxito.
E_NOTIMPL
 Essa fábrica de classes não dá suporte a chaves de licença em tempo de execução.
E_POINTER
 O endereço passado em pbstrKey não é válido. Por exemplo, pode ser NULL.
CLASS_E_NOTLICENSED
 Essa fábrica de classes dá suporte ao licenciamento em tempo de execução, mas o próprio computador atual não está licenciado. Portanto, uma chave de tempo de execução não está disponível neste computador.

Comentários

O chamador pode salvar a chave de licença para chamadas subsequentes para IClassFactory2::CreateInstanceLic para criar objetos em um computador sem licença.

Anotações aos Chamadores

O chamador deve liberar o BSTR com a função SysFreeString quando a chave não for mais necessária. O valor de fRuntimeKeyAvail é retornado por meio de uma chamada anterior para IClassFactory2::GetLicInfo.

Observações aos implementadores

Esse método aloca a chave BSTR com SysAllocString ou SysAllocStringLen e o chamador se torna responsável por esse BSTR depois que esse método retorna com êxito.

Esse método não precisa ser implementado quando uma fábrica de classes não dá suporte a chaves de licença em tempo de execução.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h

Confira também

Iclassfactory2