ActivateAtStorage
Servers can
install this named-value on client machines. When this value is not overridden
by certain parameters passed to distributed COM activation API functions, the ActivateAtStorage
named-value configures the client to instantiate objects on the same machine as
the persistent state they are using or from which they are initialized.
Registry Entry
HKEY_LOCAL_MACHINE\SOFTWARE\Classes\APPID\
{ AppID_value}\ActivateAtStorage
= value
Remarks
The ActivateAtStorage
named-value can be set by the server to configure the client to instantiate its
objects on the same machine as the persistent state used or from which the
objects are initialized. The value is a REG_SZ; any value beginning with Y
or y means that ActivageAtStorage should be used.
When a value
is set for ActivateAtStorage, this becomes the default behavior in calls
to the CoGetInstanceFromFile
and CoGetInstanceFromIStorage
functions, as well as to the file moniker implementation of IMoniker::BindToObject.
In all of
these calls, specifying a COSERVERINFO structure overrides the setting
of ActivateAtStorage for the duration of the function call. The caller
can pass COSERVERINFO information to IMoniker::BindToObject through the BIND_OPTS2
structure.
The value set
for ActivateAtStorage is also the default behavior when
CLSCTX_REMOTE_SERVER is specified if no registry information for the class is
installed on the client s machine. Client applications written to take
advantage of ActivateAtStorage may therefore require less
administration.
The ActivateAtStorage
capability provides a transparent way to allow clients to locate running
objects on the same machine as the data that they use. This reduces network
traffic, because the object performs local file-system calls instead of calls
across the network.
See Also