IDebugDocumentContext2 : : GetName
obtient le nom affichable du document qui contient ce contexte de document.
HRESULT GetName(
GETNAME_TYPE gnType,
BSTR* pbstrFileName
);
int GetName(
enum_GETNAME_TYPE gnType,
out string pbstrFileName
);
Paramètres
gnType
[in] Une valeur de l'énumération de GETNAME_TYPE qui spécifie le type de nom à retourner.pbstrFileName
[out] Retourne le nom du fichier.
Valeur de retour
En cas de réussite, retourne S_OK; sinon, retourne un code d'erreur.
Notes
Cette méthode effectue le suivi en général à l'appel de la méthode d' IDebugDocument2 : : GetName , à moins que le contexte de document ne soit écrit pour stocker le nom de document (comme afficher d'exemple).
Exemple
L'exemple suivant indique comment appliquer cette méthode d'un objet simple d' CDebugContext qui expose l'interface d' IDebugDocumentContext2 .
HRESULT CDebugContext::GetName(GETNAME_TYPE gnType, BSTR* pbstrFileName)
{
HRESULT hr;
// Check for a valid file name argument.
if (pbstrFileName)
{
*pbstrFileName = NULL;
switch (gnType)
{
case GN_NAME:
case GN_FILENAME:
{
// Copy the member file name into the local file name.
*pbstrFileName = SysAllocString(m_sbstrFileName);
// Check for successful copy.
hr = (*pbstrFileName) ? S_OK : E_OUTOFMEMORY;
break;
}
default:
{
hr = E_FAIL;
break;
}
}
}
else
{
hr = E_INVALIDARG;
}
return hr;
}