ILocalRegistry4.GetLocalRegistryRootEx(UInt32, UInt32, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt den lokalen Registrierungsstamm zurück.
public:
int GetLocalRegistryRootEx(System::UInt32 dwRegType, [Runtime::InteropServices::Out] System::UInt32 % pdwRegRootHandle, [Runtime::InteropServices::Out] System::String ^ % pbstrRoot);
int GetLocalRegistryRootEx(unsigned int dwRegType, [Runtime::InteropServices::Out] unsigned int & pdwRegRootHandle, [Runtime::InteropServices::Out] std::wstring const & & pbstrRoot);
public int GetLocalRegistryRootEx (uint dwRegType, out uint pdwRegRootHandle, out string pbstrRoot);
abstract member GetLocalRegistryRootEx : uint32 * uint32 * string -> int
Public Function GetLocalRegistryRootEx (dwRegType As UInteger, ByRef pdwRegRootHandle As UInteger, ByRef pbstrRoot As String) As Integer
Parameter
- dwRegType
- UInt32
[in] Ein __VsLocalRegistryType-Wert, der den Registrierungshive angibt.
- pdwRegRootHandle
- UInt32
[in] Ein __VsLocalRegistryRootHandle-Wert, der das Registrierungsstammhandle angibt.
- pbstrRoot
- String
[out] Zeiger auf eine Zeichenfolge, die den lokalen Registrierungsstamm enthält.
Gibt zurück
Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.
Beispiele
ILocalRegistry4* pLocalRegistry = /* Get the local registry */
VSLOCALREGISTRYROOTHANDLE hKey = RegHandle_Invalid;
BSTR bstrPath = NULL;
if( SUCCEEDED( pLocalRegistry->GetRegistryRootEx(
RegType_UserSettings, &hKey, &bstrPath ) ) )
{
HKEY hkUser = NULL;
LONG lr = RegOpenKeyEx( hKey, bstrPath, 0, KEY_READ, &hkUser );
if( ERROR_SUCCESS == lr )
{
// Query values as needed
RegCloseKey( hkUser );
}
SysFreeString(bstrPath);
}
Hinweise
GetLocalRegistryRootEx sollte für den gesamten neuen Code verwendet werden, der Zugriff auf den Registrierungs Stamm benötigt. Die-Methode ermöglicht das Platzieren der computerspezifischen Konfigurations Teile der Registrierung unter einem anderen Registrierungsschlüssel und/oder Pfad.
Der entsprechende Dienst ist SID_SLocalRegistry
Diese Schnittstelle ist Thread sicher und kann von einem Hintergrund Thread direkt oder mithilfe eines gemarshallten Zeigers aufgerufen werden.