IOPLEX
Communications Software
Plexcel for PHP - Active Directory PHP Integration
plexcel_new
plexcel_status
plexcel_find_authorities_by_domain
plexcel_get_authority
plexcel_get_domain
plexcel_log
plexcel_preamble
plexcel_authenticate
plexcel_sso
plexcel_logon
plexcel_logoff
plexcel_accept_token
plexcel_is_member_of
plexcel_set_password
plexcel_change_password
plexcel_gen_service_keytab
plexcel_search_objects
plexcel_get_account
plexcel_add_object
plexcel_modify_object
plexcel_delete_object
plexcel_set_attrdefs
plexcel_get_attrdefs
plexcel_set_conv_attrdefs

plexcel_get_domain

Printer Friendly Format

Synopsis

array plexcel_get_domain(resource $px, string $dname)

Description

The plexcel_get_domain function retrieves information about the named domain including it's dnsRoot , nETBIOSName and objectSid .

This function is particularly useful for canonicalizing usernames before calling plexcel_logon (e.g. convert EXAMPLE\username to username@example.com as required by plexcel_logon ).

Note: Currently this function cannot be used with NetBIOS domain names unless the corresponding DNS name is resolved first. Plexcel currently does not support NetBIOS name lookups.

Returns

The plexcel_get_domain function returns an array of attributes or FALSE to indicate that an error has occurred in which case plexcel_status should be consulted.

Example

The following PHP script prints information about the specified domain.

<?php

$dname = 'example.com';

$px = plexcel_new(null, null);
if (!$px)
    die('<pre>' . plexcel_status(NULL) . '</pre>');

$domain = plexcel_get_domain($px, $dname);
if ($domain === FALSE)
    die('<pre>' . plexcel_status($px) . '</pre>');

echo '<pre>';
print_r($domain);
echo '</pre>';
Retrieving the NetBIOSName, dnsRoot and objectSid of a domain with plexcel_get_domain.
© 2008 IOPLEX Software | Contact Us | Policies