Localizando cadeias de caracteres de mensagem

2023-06-12

Cada cadeia de caracteres de mensagem especificada no manifesto deve referenciar uma cadeia de caracteres na seção de localização do manifesto. A seção de localização contém uma seção de tabela de cadeia de caracteres para cada localidade compatível.

O exemplo a seguir mostra como definir uma tabela de cadeia de caracteres. Você deve especificar a ID da cadeia de caracteres e os atributos de valor . Use o valor do atributo id para fazer referência à cadeia de caracteres no manifesto. O atributo value contém a cadeia de caracteres localizada.

<instrumentationManifest
    xmlns="http://schemas.microsoft.com/win/2004/08/events" 
    xmlns:win="http://manifests.microsoft.com/win/2004/08/windows/events"
    xmlns:xs="http://www.w3.org/2001/XMLSchema"
    >

    <instrumentation>
        <events>
            <provider name="Microsoft-Windows-SampleProvider" 
                guid="{1db28f2e-8f80-4027-8c5a-a11f7f10f62d}" 
                symbol="PROVIDER_GUID" 
                resourceFileName="<path to the exe or dll that contains the metadata resources>" 
                messageFileName="<path to the exe or dll that contains the string resources>"
                message="$(string.ProviderName)">

                . . .

            </provider>
        </events>
    </instrumentation>

    <localization>
        <resources culture="en-US">
            <stringTable>
                <string id="ProviderName" value="Sample Provider"/>
                <string id="PathNotFound" value="The path %1 was not found."/>
            </stringTable>
        </resources>
    </localization>

</instrumentationManifest>

Em vez de adicionar cadeias de caracteres localizadas ao manifesto, você deve criar um arquivo MUI (interface do usuário multilíngue) para cada idioma compatível. Use um arquivo de texto de mensagem para especificar suas cadeias de caracteres localizadas.

O procedimento a seguir descreve como criar um arquivo MUI para inglês e francês.

Para criar um arquivo MUI para inglês e francês

Crie um arquivo de texto de mensagem que cria as cadeias de caracteres de mensagem em francês. Para obter detalhes sobre como criar um arquivo de texto de mensagem, consulte Arquivos de Texto de Mensagem. Os identificadores de mensagem especificados no arquivo de texto da mensagem devem corresponder aos identificadores de recurso gerados pelo compilador de mensagens para as mesmas cadeias de caracteres no manifesto. Para determinar os identificadores de recurso usados para as cadeias de caracteres no manifesto, consulte o arquivo .h gerado pelo compilador de mensagens quando você compilou o manifesto.
```
LanguageNames=(French=0x40C:MSG0040C)

; // The following are message definitions.

MessageId=0x00000065
SymbolicName=MSG_ProviderName
Language=French
<FRENCH STRING GOES HERE>
.


MessageId=0x00000066
SymbolicName=MSG_PathNotFound
Language=French
<FRENCH STRING GOES HERE>
.
```
Execute os comandos a seguir para criar a DLL de recurso que contém suas cadeias de caracteres localizadas. O arquivo messages.mc é o arquivo de texto da mensagem que você criou na etapa 1.
```
mc -u -U messages.mc

rc -r messages.rc

link -dll -noentry -out:messages.dll messages.res
```
Na pasta que contém seu provedor, crie uma subpasta para cada localidade compatível. O nome da subpasta deve ser o nome do idioma dessa localidade. Por exemplo, para 0x0409, use en-US como o nome da pasta.

Crie um arquivo .rcconfig que informa à ferramenta Muirct.exe que você deseja dividir os recursos de cadeia de caracteres de mensagem do executável e das DLLs do recurso. Veja a seguir um exemplo de arquivo .rcconfig.

<localization>
      <resources>
            <win32Resources fileType="Application">
                  <neutralResources>
                  </neutralResources>
                  <localizedResources>
                        <resourceType typeNameId="#11"/>
                  </localizedResources>
            </win32Resources>
      </resources>
</localization>

Execute os seguintes comandos Muirct.exe para dividir as cadeias de caracteres em inglês do arquivo executável do provedor.

muirct -q split.rcconfig -v 2 -x 0x0409 -g 0x0409 provider.exe provider.exe.ln en-US\provider.exe.mui

muirct -c provider.exe.ln -e en-US\provider.exe.mui

Execute os comandos Muirct.exe a seguir para dividir as cadeias de caracteres em francês da DLL do recurso. Remova o arquivo neutro de linguagem (fr-FR\messages.dll) após a criação do arquivo MUI.
```
muirct -q split.rcconfig -v 2 -x 0x040C -g 0x0409 messages.dll fr-FR\messages.dll fr-FR\provider.exe.mui

muirct -c provider.exe.ln -e fr-FR\provider.exe.mui
```
Renomeie provider.exe.ln para provider.exe.

Compartilhar via

Localizando cadeias de caracteres de mensagem

Comentários

Recursos adicionais