IServerSecurity
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa interface é usado por um servidor para autenticar o cliente e para gerenciar representação do cliente.
Quando um cliente chama um servidor, o servidor pode chamar CoGetCallContext Para get um ponteiro para o IServerSecurity interface implementada no objeto de contexto chamar para o atual método chamar. Esse ponteiro pode ser usado para chamar um IServerSecurity método que permite que o servidor para verificar autenticação do cliente ou para representar o cliente.
O ponteiro para a instância do IServerSecurity retornado por CoGetCallContext é automaticamente excluído quando o servidor envia a resposta voltar para o cliente. Portanto, o IServerSecurity objeto é válido somente para a duração do chamar. O IServerSecurity ponteiro deve ser liberado quando ele não for mais necessária.
Quando a implementar
Codificar o gerenciamento stub no sistema fornece uma implementação de IServerSecurity Para objetos Por padrão como parte de cada de entrada chamar, caso geralmente faria não implementar essa interface.
Você pode escolher para implementar IServerSecurity Sobre o personalizado stubs de objetos que empacotamento personalizado suporte para manter um consistente modelo programação para seus objetos.
Antes distribuindo um chamar chegada, personalizado chamar empacotadores CoSwitchCallContext, especificando um novo objeto contexto (que deve implementar IServerSecurity). O original contexto chamar deve ser restaurado após o objeto servidor envia uma resposta.
Quando usar
Os métodos de IServerSecurity interface são chamado por um objeto servidor para examinar as configurações de segurança de um determinado chamar entre um cliente e o (objeto servidorQueryBlanket) ou para representar o cliente (ImpersonateClient e RevertToSelf).
Um servidor personifica um cliente pela execução na contexto de segurança do cliente, que permite que o servidor para testar o privilégio nível do cliente chamado e acessar recursos (such as arquivos) como o cliente.
Para obter mais informações sobre como representação funciona, consulte a representação e Cloaking.
As informações obtidas por meio IServerSecurity Também permite que um objeto para executar verificações de segurança in addition para o ACL automática verifica executa COM. De exemplo, um aplicativo pode desejar permitir tempo de dia acessar alguns objetos ou ter um ACL diferente para cada método em um objeto.
IServerSecurity métodos podem ser chamado somente antes o remoto chamar procedimento conclui.
Métodos na ordem TabelaV
| Método IUnknown | Descrição |
|---|---|
Retorna os ponteiros para com suporte interfaces. |
|
Incrementa a contagem de referência. |
|
Diminui o contagem de referência. |
| Método | Descrição |
|---|---|
Chamado pelo servidor para localizar saída sobre o cliente que chamado um dos seus métodos. |
|
Permite que um servidor para representar um cliente para a duração de uma chamar. |
|
Restaura o informações sobre autenticação em um segmento. |
|
Indica se o servidor no momento está representando o cliente. |
Remarks
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requisitos
| Header | objidl.h, objidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |