Método IBindCtx::RevokeObjectParam (objidl.h)

  • Artigo

Remove a chave especificada e seu ponteiro associado da tabela de objetos com chave de cadeia de caracteres do contexto de associação. A chave deve ter sido inserida anteriormente na tabela com uma chamada para RegisterObjectParam.

Sintaxe

HRESULT RevokeObjectParam(
  [in] LPOLESTR pszKey
);

Parâmetros

[in] pszKey

A chave de cadeia de caracteres de contexto de associação a ser removida. A comparação de cadeia de caracteres de chave diferencia maiúsculas de minúsculas.

Retornar valor

Esse método pode retornar os valores a seguir.

Código de retorno Descrição
S_OK
 A chave especificada foi removida com êxito.
S_FALSE
 O objeto não foi registrado anteriormente.

Comentários

Um contexto de associação mantém uma tabela de ponteiros de interface, cada um associado a uma chave de cadeia de caracteres. Isso permite a comunicação entre uma implementação de moniker e o chamador que iniciou a operação de associação. Uma parte pode armazenar um ponteiro de interface sob uma cadeia de caracteres conhecida por ambas as partes para que a outra parte possa recuperá-lo posteriormente do contexto de associação.

Esse método é usado para remover uma entrada da tabela. Se a chave especificada for encontrada, o contexto de associação também liberará sua referência ao objeto .

Requisitos

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

Confira também

Ibindctx