Share via


IpcInitialize function

Locates the installed version of Msipc.dll and calls the Windows LoadLibrary against it. IpcInitialize is made available through a static library, msipc_s.lib.

[!Important]
This function should be called before any other Rights Management Services SDK 2.1 function, otherwise the system may not work properly.

After calling IpcInitialize, your next call should be to IpcInitializeEnvironment.

Syntax

HRESULT WINAPI IpcInitialize(void);

Parameters

This function has no parameters.

Return value

If the function succeeds, the return value is S_OK. If the function fails, it returns an HRESULT value that indicates the error.

For more information, see Error codes for a description of all RMS SDK 2.1 return values.

Remarks

For installation information about Msipc.dll, see the reference topic SDK elements.

The msipc.dll must be delay loaded as part of your project configuration in Visual Studio. For more information, see step 4 in How to configure Visual Studio for AD RMS SDK 2.1.

There is currently no corresponding IpcUninitialize function to free this library.

After Msipc.dll is loaded in a process, it cannot be unloaded.

It is not safe to call IpcInitialize from within DllMain.

IpcInitialize is made available through a static library, msipc_s.lib.

Requirements

Minimum supported client
Windows Vista with SP2
Minimum supported server
Windows Server 2008
Header
Ipcbase.h (include Msipc.h)
Library
Msipc_s.lib

See also

DllMain

Error codes

IpcInitialize

IpcInitializeEnvironment

LoadLibrary

SDK elements