CWinApp::GetProfileString

Artículo
02/19/2013

Llame a esta función miembro para recuperar la cadena asociado a una entrada de la sección especificada en el registro de la aplicación o el archivo de .INI.

CString GetProfileString(
   LPCTSTR lpszSection,
   LPCTSTR lpszEntry,
   LPCTSTR lpszDefault = NULL 
);

Parámetros

lpszSection
Señala una cadena terminada en null que especifica la sección que contiene la entrada.
lpszEntry
Señala una cadena terminada en null que contiene la entrada cuya cadena debe recuperar.este valor no debe ser NULL.
lpszDefault
Señala al valor de cadena predeterminado para la entrada especificada si la entrada no se encuentra en el archivo de inicialización.

Valor devuelto

El valor devuelto es la cadena de archivo o de lpszDefault de .INI de la aplicación si la cadena no se encuentra.la longitud máxima de la cadena admitida por el marco es _MAX_PATH.si lpszDefault es NULL, el valor devuelto es una cadena vacía.

Comentarios

Nota sobre la seguridad
Los datos devueltos por esta función no es necesariamente NULL finalizado, y el llamador debe realizar la validación.Para obtener más información, vea Para evitar las saturaciones del búfer.

Ejemplo

CWinApp* pApp = AfxGetApp();

CString strSection       = _T("My Section");
CString strStringItem    = _T("My String Item");
CString strIntItem       = _T("My Int Item");

pApp->WriteProfileString(strSection, strStringItem, _T("test"));

CString strValue;
strValue = pApp->GetProfileString(strSection, strStringItem);
ASSERT(strValue == _T("test"));

pApp->WriteProfileInt(strSection, strIntItem, 1234);

int nValue;
nValue = pApp->GetProfileInt(strSection, strIntItem, 0);
ASSERT(nValue == 1234);

Para obtener otro ejemplo, vea el ejemplo para CWinApp:: GetProfileInt.