Compartilhar via


Função CoAllowUnmarshalerCLSID (combaseapi.h)

Adiciona um CLSID sem formação à lista de permissões somente para o processo de chamada.

Sintaxe

HRESULT CoAllowUnmarshalerCLSID(
  [in] REFCLSID clsid
);

Parâmetros

[in] clsid

O CLSID do unmarshaler a ser adicionado à lista permitida por processo.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Não chame a função CoAllowUnmarshalerCLSID até que CoInitializeSecurity tenha sido chamado no processo atual.

A função CoAllowUnmarshalerCLSID fornece um controle mais granular sobre a política de unmarshaling do que é fornecido pelas opções de política. Se o processo aplicar qualquer política de unmarshaling, o efeito da função CoAllowUnmarshalerCLSID será tornar a política relativamente mais fraca. Por esse motivo, chame apenas CoAllowUnmarshalerCLSID quando o impacto na segurança for bem compreendido. Normalmente, isso é usado para facilitar a aplicação de uma opção de política de unmarshaling mais forte para a redução ampla da superfície de ataque que isso fornece, quando um CLSID não demarcador específico não permitido por essa opção é necessário devido a outras restrições.

Por exemplo, é apropriado chamar a função CoAllowUnmarshalerCLSID quando um unmarshaler é conhecido ou acredita-se ter uma vulnerabilidade, mas é exigido por um aplicativo. Além disso, é apropriado chamar CoAllowUnmarshalerCLSID se o unmarshaler for usado em vários processos, mas apenas como parte de um recurso incomum. Não use a função CoAllowUnmarshalerCLSID como uma substituição para proteger o unmarshaler.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho combaseapi.h
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

GLOBALOPT_UNMARSHALING_POLICY_VALUES

IMarshalingStream