IAppManagementHandler::EnforceApp — Metoda

Metoda IAppManagementHandler::EnforceApp w Configuration Manager rozpoczyna instalację określonej aplikacji.

Jeśli program obsługi obsługuje ponowne nawiązywanie połączenia, musi zwrócić prawidłowe wystąpienie ponownego połączenia z usługą ppReconnectData. Jeśli z jakiegokolwiek powodu instalacja nie może się rozpocząć, ale nie jest w stanie błędu, na przykład nie ma tokenu użytkownika do wyświetlenia, program obsługi powinien zwrócić S_FALSEwartość .

Składni

[IDL]
HRESULT EnforceApp(
     AppAction eEnforceAction,
     HANDLE hUserToken,
     DWORD dwSessionId,
     IWbemClassObject* pHandlerSynclet,
     LPCWSTR szLocalContentPath,
     HANDLE* phInstallProcess,
     DWORD* pdwExitCode,
     LPWSTR* ppszExecutionStatus,
     IWbemClassObject** ppReconnectData
);

Parametry

eEnforceAction Typ danych: AppAction

Kwalifikatory: [w]

.

hUserToken Typ danych: HANDLE

Kwalifikatory: [w]

.

dwSessionId Typ danych: DWORD

Kwalifikatory: [w]

.

pHandlerSynclet Typ danych: IWbemClassObject

Kwalifikatory: [w]

.

szLocalContentPath Typ danych: LPCWSTR

Kwalifikatory: [w]

.

phInstallProcess Typ danych: HANDLE

Kwalifikatory: [out]

.

pdwExitCode Typ danych: DWORD

Kwalifikatory: [out]

.

ppszExecutionStatus Typ danych: LPWSTR

Kwalifikatory: [out]

.

ppReconnectData Typ danych: IWbemClassObject

Kwalifikatory: [out]

.

Wartości zwracane

Kod HRESULT . Możliwe wartości obejmują, ale nie są ograniczone do następujących:

S_OK Metoda zakończyła się pomyślnie. Wszystkie inne wartości zwracane wskazują na błąd. Jeśli z jakiegokolwiek powodu instalacja nie może się rozpocząć, ale nie jest w stanie błędu, na przykład nie ma tokenu użytkownika do wyświetlenia interfejsu użytkownika, program obsługi powinien zwrócić S_FALSE

Wymagania

Wymagania dotyczące środowiska uruchomieniowego

Aby uzyskać więcej informacji, zobacz Configuration Manager Wymagania dotyczące środowiska uruchomieniowego klienta.

Wymagania programistyczne

Aby uzyskać więcej informacji, zobacz Configuration Manager Wymagania dotyczące programowania klientów.

Zobacz też

IAppManagementHandler InterfaceApplication Management Client InterfacesConfiguration Manager Software Development KitConfiguration Manager Reference