_pgmptr, _wpgmptr

O caminho do arquivo executável. Deprecado; uso _get_pgmptr e _get_wpgmptr.

Sintaxe

extern char *_pgmptr;
extern wchar_t *_wpgmptr;

Comentários

Quando um programa é executado do interpretador de comandos (Cmd.exe), o _pgmptr é inicializado automaticamente para o caminho completo do arquivo executável. Por exemplo, se Hello.exe estiver em C:\BIN e C:\BIN estiver no caminho, _pgmptr será definido como C:\BIN\Hello.exe quando você executar:

C> hello

Quando um programa não é executado a partir da linha de comando, _pgmptr pode ser inicializado para o nome do programa (o nome base do arquivo sem a extensão de nome de arquivo) ou para um nome de arquivo, caminho relativo ou caminho completo.

_wpgmptr é a contraparte de caractere largo de _pgmptr para uso com programas que utilizam wmain.

Mapeamentos de rotina de texto genérico

Rotina Tchar.h	_UNICODE e _MBCS não definidos	_MBCS definido	_UNICODE definido
_tpgmptr	_pgmptr	_pgmptr	_wpgmptr

Requisitos

Variável	Cabeçalho necessário
_pgmptr, _wpgmptr	<stdlib.h>

Exemplo

O programa a seguir demonstra o uso de _pgmptr.

// crt_pgmptr.c
// compile with: /W3
// The following program demonstrates the use of _pgmptr.
//
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
   printf("The full path of the executing program is : %Fs\n",
     _pgmptr); // C4996
   // Note: _pgmptr is deprecated; use _get_pgmptr instead
}

É possível usar _wpgmptr alterando %Fs para %S e main para wmain.

Confira também

Variáveis globais