Microsoft Sharepoint Products and Technologies Resource Kit eBook

928 Part IX: Maintaining a Server in Windows SharePoint Services
The bForce parameter can be set to true to overwrite an existing Web Part
package with a new version.
Finally, the logWriter parameter contains a System.IO.TextWriter object that is
used to write an error log to the text stream.
Before you can call the AddWPPack method, you should create an instance of
the SPGlobalAdmin class. The following code example can be copied into a Web
Part. Because this is just an example, the AllowUnsafeUpdates property of the
SPGlobalAdmin class is set to true so that updates are allowed to the database as a
result of a GET request. If you do not set this property, the AddWPPack method will
fail after an HTTP GET request. This opens a security risk. In real world situations
you would probably call the AddWPPack method in a non-HTTP context, from
either a command-line executable or a Windows application. If you want to call the
AddWPPack method in an HTTP context, you should send an HTTP POST request
and add the AdminFormDigest control to the form body, which is discussed later in
the “Microsoft.SharePoint.WebControls Namespace” section.
SPGlobalAdmin myGlobalAdmin = new SPGlobalAdmin();
myGlobalAdmin.AllowUnsafeUpdates = true;
myGlobalAdmin.AddWPPack(@"C:\projects\ResKitCab\Debug\ResKitCab.cab", null, 1033,
null, true, true, null);
The EnumWPPack Method
The following code example shows how to return a string containing all the Web Part
packages installed on the virtual server. You can do this by using the EnumWPPack
method of the SPGlobalAdmin class. The signature of the EnumWPPack method looks
like this:
public string EnumWPPacks(
string strName,
string strURL,
bool bEntireFarm
);
The strName parameter contains the name of a Web Part package or null. The
strURL parameter contains the URL for the virtual server or null. The bEntireFarm
parameter has the value true when you want to list the Web Part packages currently
installed on a server farm; otherwise, it contains false or null. The return value contains
information about Web Part packages that are installed. The format of this
string depends on which parameters are used.
Before you can call the EnumWPPacks method, you should create an instance
of the SPGlobalAdmin class. The code example shown here can be copied into a
Web Part. This code example will return the host name, the name of the .cab file and
the locale, and the virtual server name.
SPGlobalAdmin myGlobalAdmin = new SPGlobalAdmin();
strReturn = myGlobalAdmin.EnumWPPacks(null, "http://woodgrove/", true);