Partager via


IDebugProgramNode2 : : GetHostName

Obtient le nom de l'hébergement de processus du programme.

HRESULT GetHostName ( 
   GETHOSTNAME_TYPE dwHostNameType,
   BSTR*            pbstrHostName
);
int GetHostName ( 
   enum_GETHOSTNAME_TYPE dwHostNameType,
   out string            pbstrHostName
);

Paramètres

  • dwHostNameType
    [in] Une valeur de l'énumération de GETHOSTNAME_TYPE qui spécifie le type de nom à retourner.

  • pbstrHostName
    [out] Retourne le nom du processus d'hébergement.

Valeur de retour

En cas de réussite, retourne S_OK; sinon, retourne un code d'erreur.

Exemple

L'exemple suivant indique comment appliquer cette méthode d'un objet simple d' CProgram qui expose l'interface d' IDebugProgramNode2 . Cet exemple ignore le paramètre d' dwHostNameType et retourne uniquement le nom du programme comme extraits du nom de base du chemin d'accès de fichier du module.

HRESULT CProgram::GetHostName(DWORD dwHostNameType, BSTR* pbstrHostName) {  
   // Check for valid argument.  
   if (pbstrHostName)  
   {  
      char szModule[_MAX_PATH];  
  
      // Attempt to assign to szModule the path for the file used
      // to create the calling process.  
      if (GetModuleFileName(NULL, szModule, sizeof (szModule)))  
      {  
         // If successful then declare several char arrays  
         char  szDrive[_MAX_DRIVE];  
         char  szDir[_MAX_DIR];  
         char  szName[_MAX_FNAME];  
         char  szExt[_MAX_EXT];  
         char  szFilename[_MAX_FNAME + _MAX_EXT];  
         WCHAR wszFilename[_MAX_FNAME + _MAX_EXT];  
  
         // Break the szModule path name into components.  
         _splitpath(szModule, szDrive, szDir, szName, szExt);  
  
         // Copy the base file name szName into szFilename.  
         lstrcpy(szFilename, szName);  
         // Append the field extension szExt into szFilename.  
         lstrcat(szFilename, szExt);  
  
         // Convert the szFilename sequence of multibyte characters  
         // to the wszFilename sequence of wide characters.  
         mbstowcs(wszFilename, szFilename, sizeof (wszFilename) / 2);  
  
         // Assign the wszFilename to the value at *pbstrHostName.  
         *pbstrHostName = SysAllocString(wszFilename);  
  
          return S_OK;  
      }  
   }  
  
    return E_INVALIDARG;  
}  

Voir aussi

Référence

IDebugProgramNode2

GETHOSTNAME_TYPE

IDebugProgramNode2