Funzione DRMSetGlobalOptions (msdrm.h)

[AD RMS SDK sfruttando le funzionalità esposte da

il client in Msdrm.dll è disponibile per l'uso in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012 e Windows 8. Può essere modificato o

non disponibile nelle versioni successive. Usare invece Active Directory Rights Management Services SDK 2.1,

che sfrutta le funzionalità esposte dal client in Msipc.dll.]

La funzione DRMSetGlobalOptions imposta il protocollo di trasporto su un valore specificato e specifica facoltativamente se viene usata la casella di blocco del server.

Sintassi

DRMEXPORT HRESULT UDAPICALL DRMSetGlobalOptions(
  [in] DRMGLOBALOPTIONS eGlobalOptions,
  [in] LPVOID           pvdata,
  [in] DWORD            dwlen
);

Parametri

[in] eGlobalOptions

Valore dell'enumerazione DRMGLOBALOPTIONS che specifica l'opzione da impostare.

È possibile specificare una sola opzione in ogni chiamata a DRMSetGlobalOptions. Ad esempio, se sono necessari sia WinHTTP che la casella di blocco del server, è necessario chiamare DRMSetGlobalOptions due volte, una volta con eGlobalOptions impostata su DRMGLOBALOPTIONS_USE_WINHTTP e una volta con eGlobalOptions impostata su DRMGLOBALOPTIONS_USE_SERVERSECURITYPROCESSOR.

[in] pvdata

Puntatore a un valore void . Questo parametro non viene attualmente usato.

[in] dwlen

Dimensioni, in byte, del buffer pvdata . Questo parametro non viene attualmente usato.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. I valori possibili includono, ma non sono limitati a quelli nell'elenco seguente. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Le applicazioni non possono disattivare tra i protocolli WinHTTP e WinINet.

WinINet non supporta l'utilizzo nell'account del servizio di rete. Se un'applicazione verrà eseguita nell'account del servizio di rete, l'applicazione deve specificare l'opzione DRMGLOBALOPTIONS_USE_WINHTTP .

Un'applicazione server abilitata per AD RMS deve chiamare la funzione DRMSetGlobalOptions prima di chiamare qualsiasi altra funzione di gestione dei diritti. La chiamata a DRMSetGlobalOptions dopo che altre funzioni di gestione dei diritti sono state chiamate non cambieranno il tipo di lockbox o protocollo di trasporto in uso.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	msdrm.h
Libreria	Msdrm.lib
DLL	Msdrm.dll

Vedi anche

Funzioni DI AD RMS

DRMGLOBALOPTIONS