Partilhar via


Macros de Troca de Dados de Registo

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Estas macros realizam operações de troca de dados de registo.

Nome Description
BEGIN_RDX_MAP Marca o início do mapa da Troca de Dados do Registo.
END_RDX_MAP Marca o fim do mapa da Troca de Dados do Registo.
RDX_BINARY Associa a entrada especificada do registo a uma variável membro específica do tipo BYTE.
RDX_CSTRING_TEXT Associa a entrada especificada do registo a uma variável membro específica do tipo CString.
RDX_DWORD Associa a entrada do registo especificada a uma variável membro específica do tipo DWORD.
RDX_TEXT Associa a entrada especificada do registo a uma variável membro específica do tipo TCHAR.

Requerimentos

Cabeçalho: atlplus.h

BEGIN_RDX_MAP

Marca o início do mapa da Troca de Dados do Registo.

BEGIN_RDX_MAP

Observações

As seguintes macros são usadas no mapa da Troca de Dados do Registo para ler e escrever entradas no registo do sistema:

Macro Description
RDX_BINARY Associa a entrada especificada do registo a uma variável membro específica do tipo BYTE.
RDX_DWORD Associa a entrada do registo especificada a uma variável membro específica do tipo DWORD.
RDX_CSTRING_TEXT Associa a entrada especificada do registo a uma variável membro específica do tipo CString.
RDX_TEXT Associa a entrada especificada do registo a uma variável membro específica do tipo TCHAR.

A função global RegistryDataExchange, ou a função membro com o mesmo nome criada pelas macros BEGIN_RDX_MAP e END_RDX_MAP, deve ser usada sempre que o seu código precisar de trocar dados entre o registo do sistema e as variáveis especificadas no mapa RDX.

END_RDX_MAP

Marca o fim do mapa da Troca de Dados do Registo.

END_RDX_MAP

RDX_BINARY

Associa a entrada especificada do registo a uma variável membro específica do tipo BYTE.

RDX_BINARY(
    rootkey,
    subkey,
    valuename,
    member,
    member_size )

Parâmetros

rootkey
A raiz da chave do registo.

Subchave
A subchave do registo.

Valuename
A chave do registo.

Membro
A variável membro a associar à entrada do registo especificada.

member_size
O tamanho, em bytes, da variável membro.

Observações

Esta macro é usada em conjunto com as macros BEGIN_RDX_MAP e END_RDX_MAP para associar uma variável membro a uma dada entrada do registo. A função global RegistryDataExchange, ou a função membro com o mesmo nome criada pelas macros BEGIN_RDX_MAP e END_RDX_MAP, deve ser usada para realizar a troca de dados entre o registo do sistema e as variáveis membros no mapa RDX.

RDX_CSTRING_TEXT

Associa a entrada especificada do registo a uma variável membro específica do tipo CString.

RDX_CSTRING_TEXT(
    rootkey,
    subkey,
    valuename,
    member,
    member_size )

Parâmetros

rootkey
A raiz da chave do registo.

Subchave
A subchave do registo.

Valuename
A chave do registo.

Membro
A variável membro a associar à entrada do registo especificada.

member_size
O tamanho, em bytes, da variável membro.

Observações

Esta macro é usada em conjunto com as macros BEGIN_RDX_MAP e END_RDX_MAP para associar uma variável membro a uma dada entrada do registo. A função global RegistryDataExchange, ou a função membro com o mesmo nome criada pelas macros BEGIN_RDX_MAP e END_RDX_MAP, deve ser usada para realizar a troca de dados entre o registo do sistema e as variáveis membros no mapa RDX.

RDX_DWORD

Associa a entrada do registo especificada a uma variável membro específica do tipo DWORD.

RDX_DWORD(
    rootkey,
    subkey,
    valuename,
    member,
    member_size )

Parâmetros

rootkey
A raiz da chave do registo.

Subchave
A subchave do registo.

Valuename
A chave do registo.

Membro
A variável membro a associar à entrada do registo especificada.

member_size
O tamanho, em bytes, da variável membro.

Observações

Esta macro é usada em conjunto com as macros BEGIN_RDX_MAP e END_RDX_MAP para associar uma variável membro a uma dada entrada do registo. A função global RegistryDataExchange, ou a função membro com o mesmo nome criada pelas macros BEGIN_RDX_MAP e END_RDX_MAP, deve ser usada para realizar a troca de dados entre o registo do sistema e as variáveis membros no mapa RDX.

RDX_TEXT

Associa a entrada especificada do registo a uma variável membro específica do tipo TCHAR.

RDX_TEXT(
    rootkey,
    subkey,
    valuename,
    member,
    member_size )

Parâmetros

rootkey
A raiz da chave do registo.

Subchave
A subchave do registo.

Valuename
A chave do registo.

Membro
A variável membro a associar à entrada do registo especificada.

member_size
O tamanho, em bytes, da variável membro.

Observações

Esta macro é usada em conjunto com as macros BEGIN_RDX_MAP e END_RDX_MAP para associar uma variável membro a uma dada entrada do registo. A função global RegistryDataExchange, ou a função membro com o mesmo nome criada pelas macros BEGIN_RDX_MAP e END_RDX_MAP, deve ser usada para realizar a troca de dados entre o registo do sistema e as variáveis membros no mapa RDX.

Consulte também

Macros
RegistryDataExchange