IClientSecurity
.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 permite o controle cliente sobre as configurações de segurança para cada individual proxy interface de um objeto. Os métodos de IClientSecurity Pode ser usada para definir ou consulta as configurações de segurança de um proxy interface específica ou para copiar um proxy interface.
Cada objeto tem um Gerenciador proxy, e cada Gerenciador proxy expõe o IClientSecurity interface automaticamente. Portanto, o cliente pode consulta o Gerenciador proxy de um objeto para IClientSecurity, usando qualquer ponteiro interface no objeto.
Se a pasta Falha de QueryInterface chamar for bem-sucedido, o IClientSecurity ponteiro pode ser usado para chamar um IClientSecurity método, passar um ponteiro para o proxy interface que o cliente está interessado.
Se um chamar para Falha de QueryInterface Para IClientSecurity falhar, ambos o objeto é implementado no - processo ou ele é remoto por um personalizado empacotador que não suporte COM Não funcionalidade de segurança. (Um personalizado pode empacotador COM funcionalidade de segurança, Oferecendo suporte a IClientSecurity interface para o cliente.)
Os proxies interface passados como parâmetros para IClientSecurity Métodos devem estar entre o mesmo objeto como o IClientSecurity interface. Isto é, cada objeto tem um distintos IClientSecurity interface: chamado IClientSecurity Em um objeto e passando um proxy para outro objeto não será trabalho.
Além disso, você não pode transmitir uma interface para um IClientSecurity método se a interface não usar um proxy. Isso significa que interfaces implementadas localmente por Gerenciador o proxy não podem ser passadas para IClientSecurity métodos, exceto para IUnknown, que é a exceção a essa regra.
Para obter mais informações sobre como proxies, consulte Implementação padrão IMarshal.
Quando a implementar
O Gerenciador proxy para cada objeto fornece uma implementação de IClientSecurity, para que você faria geralmente não implementar essa interface.
No entanto, se você estiver definindo os objetos que empacotamento personalizado suporte, você pode escolher para implementar IClientSecurity Em ' os objetos personalizado proxies para manter um consistente modelo programação para ' os objetos Aplicativos cliente.
Você pode também suporte esta interface no in-processo objetos.
Quando usar
Chamar os métodos desta interface para examinar ou modificar as configurações de segurança de uma conexão específica para um fora - de - objeto processo.
De exemplo, você pode estabelecer temporariamente uma segurança mais alta nível — um com criptografia complexa — somente para o período quando informações sigilosas ou dados são enviados para o objeto.
Como alternativa, você pode estabelecer diferentes proxies para o mesmo objeto com diferentes níveis de segurança. Você pode usar esses níveis de segurança para clientes diferentes suporte que são chamado seu objeto ou para suporte diferente operações em seu aplicativo.
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 |
|---|---|
Recupera informações sobre autenticação. |
|
Define o informações sobre autenticação que será usado para fazer chamadas no proxy especificado. |
|
Torna uma copiar do proxy especificado. |
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 |